Récupérer l’état de validation d’un client

Article
10/07/2024

Un partenaire peut récupérer l’état d’une validation du client à la demande.

Prérequis

Informations d’identification établies comme décrit dans l’authentification de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.
ID client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace de partenaires en sélectionnant l’espace de travail Clients, puis le client dans la liste des clients, puis compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est identique à l’ID client (customer-tenant-id).

C#

Pour récupérer l’état de validation d’un client pour son compte, commencez par créer une énumération représentant le ValidationType à récupérer. Ensuite, appelez la méthode IAggregatePartner.Customers.ById avec l’identificateur du client. Utilisez ensuite la propriété ValidationStatus pour récupérer une interface IValidationStatus. Enfin, appelez GetValidationStatus() ou GetValidationStatusAsync() utilisez la variable enum de type de validation comme paramètre d’entrée.

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

Exemple : Exemple d’application de console. Projet : SdkSamples , classe : GetValidationStatus.cs

Demande REST

Syntaxe de la requête

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

Paramètre d’URI

Utilisez le paramètre de requête suivant pour spécifier le client pour lequel vous récupérez l’état de validation.

Nom	Type	Requise	Description
{customer-id}	guid	Y	La valeur est un GUID mis en forme CustomerTenantId qui vous permet de spécifier un client.
type	string	Y	Type d’état de validation à récupérer.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Réponse REST

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et d’autres informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Champs de réponse

Champ	Type	Description	Notes
Type	Enum	Type d’informations de validation	Mêmes données que le type de validation. Le type de validation retourne le compte comme type de réponse.
État	string	Statut de validation	États disponibles : Inconnu, UnderReview, Allowed, NotAllowed, Not Ready
Dernière heure de mise à jour	string	heure de la dernière mise à jour de l’état au format UTC	L’heure de date n’est plus remplie et sera une chaîne vide.

Exemples de réponse

État autorisé

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

Dans l’état de révision

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

État non autorisé

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

État Inconnu

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

État Non prêt

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

Erreur 404 introuvable

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

Éligibilité de l’achat

Les transactions du client sont bloquées si leur compte possède l’un des états ci-dessous :

UnderReview
Non autorisé
Inconnu

Les transactions du client ne sont pas bloquées lorsqu’elles répondent aux conditions suivantes :

Le client a un état Autorisé
Le client n’a pas l’état du compte

Partager via