Abrufen der Validierungs-status eines Kunden

Ein Partner kann die status einer Kundenvalidierung auf Anfrage abrufen.

Voraussetzungen

• Etablierte Anmeldeinformationen wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.

• Eine Kunden-ID (Customer-Tenant-ID). Wenn Sie die Kunden-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden und dann den Kunden aus der Kundenliste und dann Konto auswählen. Suchen Sie auf der Seite Konto des Kunden im Abschnitt Kundenkontoinformationen nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).

C#

Um die Validierungs-status eines Kunden für sein Konto abzurufen, erstellen Sie zuerst eine Enumeration, die den abzurufenden ValidationType darstellt. Rufen Sie dann die IAggregatePartner.Customers.ById-Methode mit dem Kundenbezeichner auf. Verwenden Sie dann die ValidationStatus-Eigenschaft , um eine IValidationStatus-Schnittstelle abzurufen. Rufen Sie GetValidationStatus() abschließend oder GetValidationStatusAsync() mit der Validierungstyp-Enumerationsvariable als Eingabeparameter auf.

var validationTypeToFetch = ValidationType.Account;
var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).ValidationStatus.GetValidationStatus(validationTypeToFetch);

Beispiel: Konsolenbeispiel-App. Projekt: SdkSamples-Klasse: GetValidationStatus.cs

REST-Anforderung

Anforderungssyntax

Methode	URI
GET	{baseURL}/v1/customers/{customer-id}/validationStatus?type=account

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um den Kunden anzugeben, für den Sie die Überprüfung abrufen status.

Name	Typ	Erforderlich	BESCHREIBUNG
{customer-id}	guid	J	Der Wert ist eine GUID-formatierte CustomerTenantId, mit der Sie einen Kunden angeben können.
Typ	Zeichenfolge	J	Der Typ der abzurufenden Überprüfung status.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

REST-Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Antwortfelder

Feld	Typ	BESCHREIBUNG	Notizen
Typ	Enumeration	Validierungsinformationstyp	Dieselben Daten wie validierungstyp. Der Überprüfungstyp gibt das Konto als Antworttyp zurück.
Status	Enumeration	Validierungsstatus	Verfügbare Status: Unbekannt, UnderReview, Allowed, NotAllowed, Not Ready
Neueste Updatezeit	Zeichenfolge	Letzte status Aktualisierungszeit in UTC

Beispielantworten

Zulässige status

{
    "type": "account",
    "status": "Allowed",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

Im Überblick status

{
    "type": "account",
    "status": "UnderReview",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

NotAllowed status

{
    "type": "account",
    "status": "NotAllowed",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

Status „Unbekannt“

{
    "type": "account",
    "status": "Unknown",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

Nicht bereit status

{
    "type": "account",
    "status": "Not Ready",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

Fehler 404 nicht gefunden

{
    "code": 600074,
    "message": "Account Status for the customer, {customer-id} was not found.",
    "description": "Account Status for the customer, {customer-id} was not found.",
    "errorName": "AccountStatusNotFound",
    "isRetryable": false,
    "errorMessageExtended": "InternalErrorCode=600074"

Kaufberechtigung

Transaktionen des Kunden werden blockiert, wenn sein Konto einen der folgenden Status aufweist:

• UnderReview
• Nicht zulässig
• Unbekannt

Transaktionen des Kunden werden nicht blockiert, wenn sie die folgenden Bedingungen erfüllen:

• Der Kunde verfügt über eine zulässige status
• Der Kunde hat kein Konto status