Abrufen des Validierungsstatus eines Kunden

Ein Partner kann den Status einer Kundenvalidierung bei Bedarf abrufen.

Voraussetzungen

• Die festgelegten Anmeldeinformationen, beschrieben in Partner Center-Authentifizierung. Dieses Szenario unterstützt nur die Authentifizierung mit App- und Benutzeranmeldedaten.

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

C#

Um den Validierungsstatus eines Kunden für sein Konto abzurufen, erstellen Sie zunächst ein Enum, das 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 abschließend GetValidationStatus() oder GetValidationStatusAsync() mit der Validierungstyp-Enum-Variable 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-Anfrage

Anforderungssyntax

Methode	URI (Uniform Resource Identifier)
ERHALTEN/Bekommen	{baseURL}/v1/kunden/{kunden-id}/validationStatus?type=Konto

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um den Kunden anzugeben, für den Sie den Validierungsstatus abrufen.

Name	Typ	Erforderlich	BESCHREIBUNG
{Kunden-ID}	GUID	Ja	Der Wert ist eine CustomerTenantId im GUID-Format, mit der Sie einen Kunden angeben können.
Typ	Schnur	Ja	Der Typ des abzurufenden Validierungsstatus.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center REST-Header.

REST-Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und andere Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Antwortfelder

Feld	Typ	BESCHREIBUNG	Hinweise
Typ	Enum (Aufzählung)	Typ der Validierungsinformationen	Gleiche Daten wie validation-type. Der Validierungstyp gibt account als Antworttyp zurück.
Der Status	Schnur	Validierungsstatus	Verfügbare Status: Unbekannt, In Prüfung, Erlaubt, Nicht Erlaubt, Nicht Bereit
Letzte Aktualisierungszeit	Schnur	Zeitpunkt der letzten Statusaktualisierung in UTC	Datum und Uhrzeit wird nicht mehr ausgefüllt und ist eine leere Zeichenfolge.

Beispielantworten

Status "Erlaubt"

{
    "type": "account",
    "status": "Allowed",
    "lastUpdateDateTime": ""
}

Im Prüfstatus

{
    "type": "account",
    "status": "UnderReview",
    "lastUpdateDateTime": ""
}

NichtErlaubtStatus

{
    "type": "account",
    "status": "NotAllowed",
    "lastUpdateDateTime": ""
}

Unbekannter Status

{
    "type": "account",
    "status": "Unknown",
    "lastUpdateDateTime": ""
}

Status "Nicht bereit"

{
    "type": "account",
    "status": "Not Ready",
    "lastUpdateDateTime": ""
}

Fehler 404 - Seite 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"

Berechtigung zum Kauf

Die Transaktionen des Kunden werden gesperrt, wenn sein Konto einen der folgenden Status hat:

• In Überprüfung
• Nicht erlaubt
• Unbekannt

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

• Der Kunde hat den Status Zugelassen
• Der Kunde hat keinen Kontostatus.
• Kunde ist ein Sandkastenbenutzer