Hämta valideringsstatus för en kund

Artikel
03/08/2023

En partner kan hämta status för en kundvalidering på begäran.

Förutsättningar

Etablerade autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden i kundlistan och sedan Konto. På kundens kontosida letar du upp Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).

C#

Om du vill hämta en kunds valideringsstatus för sitt konto skapar du först en uppräkning som representerar valideringstypen som ska hämtas. Anropa sedan metoden IAggregatePartner.Customers.ById med kundidentifieraren. Använd sedan egenskapen ValidationStatus för att hämta ett IValidationStatus-gränssnitt . Anropa slutligen GetValidationStatus() eller GetValidationStatusAsync() med uppräkningsvariabeln för valideringstypen som en indataparameter.

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

Exempel: Konsolexempelapp. Projekt: SdkSamples-klass: GetValidationStatus.cs

REST-begäran

Begärandesyntax

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

URI-parameter

Använd följande frågeparameter för att ange den kund som du hämtar valideringsstatus för.

Namn	Typ	Obligatorisk	Beskrivning
{customer-id}	guid	Y	Värdet är ett GUID-formaterat CustomerTenantId som gör att du kan ange en kund.
typ	sträng	Y	Typ av valideringsstatus som ska hämtas.

Begärandehuvuden

Mer information finns i REST-huvuden i Partnercenter.

REST-svar

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Partnercenter REST-felkoder.

Svarsfält

Fält	Typ	Beskrivning	Kommentarer
Typ	Enum	Typ av verifieringsinformation	Samma data som valideringstyp. Verifieringstypen returnerar kontot som svarstyp.
Status	Enum	Valideringsstatus	Tillgängliga statusar: Unknown, UnderReview, Allowed, NotAllowed, Not Ready
Senaste uppdateringstid	sträng	senaste statusuppdateringstid i UTC

Svarsexempel

Tillåten status

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

I granskningsstatus

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

Statusen Inte tillåten

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

Okänd status

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

Statusen Är inte klar

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

Felet 404 hittades inte

{
    "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"

Berättigande till köp

Kundens transaktioner blockeras när deras konto har någon av statusarna nedan:

UnderVy
NotAllowed
Okänt

Kundens transaktioner blockeras inte när de uppfyller följande villkor:

Kunden har statusen Tillåten
Kunden har inte kontostatus

Dela via