De validatiestatus van een klant ophalen

Artikel
10/07/2024

Een partner kan de status van een klantvalidatie op aanvraag ophalen.

Vereisten

Tot stand gebrachte referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
Een klant-id (klant-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (klant-tenant-id).

C#

Als u de validatiestatus van een klant voor het account wilt ophalen, maakt u eerst een opsomming die het Validatietype vertegenwoordigt dat moet worden opgehaald. Roep vervolgens de methode IAggregatePartner.Customers.ById aan met de klant-id. Gebruik vervolgens de eigenschap ValidationStatus om een IValidationStatus-interface op te halen. Roep tot slot GetValidationStatus() de enumvariabele voor het validatietype aan als GetValidationStatusAsync() invoerparameter.

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

Voorbeeld: Consolevoorbeeld-app. Project: SdkSamples-klasse: GetValidationStatus.cs

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameter

Gebruik de volgende queryparameter om de klant op te geven waarvoor u de validatiestatus opvraagt.

Name	Type	Vereist	Beschrijving
{customer-id}	guid	J	De waarde is een door de GUID opgemaakte CustomerTenantId waarmee u een klant kunt opgeven.
type	tekenreeks	J	Het type validatiestatus dat moet worden opgehaald.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

REST-antwoord

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en andere informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Antwoordvelden

Veld	Type	Omschrijving	Opmerkingen
Type	Enum	Validatiegegevenstype	Dezelfde gegevens als het validatietype. Het validatietype retourneert het account als het antwoordtype.
Status	tekenreeks	Validatiestatus	Beschikbare statussen: Onbekend, UnderReview, Toegestaan, Niet Toegestaan, Niet gereed
Meest recente updatetijd	tekenreeks	Tijd van laatste statusupdate in UTC	Datum/tijd is niet meer ingevuld en is een lege tekenreeks.

Antwoordvoorbeelden

Toegestane status

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

Status van controle

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

Niet-toegestane status

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

Onbekende status

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

Status Niet gereed

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

Fout 404 niet gevonden

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

Geschiktheid voor aankoop

Transacties van klanten worden geblokkeerd als hun account een van de onderstaande statussen heeft:

UnderReview
Niet toegestaan
Onbekend

Transacties van klanten worden niet geblokkeerd wanneer ze aan de volgende voorwaarden voldoen:

Klant heeft de status Toegestaan
Klant heeft geen accountstatus

Delen via