Récupérer les status de validation d’un client

Un partenaire peut récupérer le status d’une validation client à la demande.

Prérequis

• Informations d’identification établies comme décrit dans 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 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 les status de validation d’un client pour son compte, créez d’abord une énumération représentant le ValidationType à récupérer. Ensuite, appelez la méthode IAggregatePartner.Customers.ById avec l’identificateur du client. Ensuite, utilisez la propriété ValidationStatus pour récupérer une interface IValidationStatus . Enfin, appelez GetValidationStatus() ou GetValidationStatusAsync() avec la variable d’énumération 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 console. Projet : SdkSamples , classe : GetValidationStatus.cs

Demande REST

Syntaxe de la requête

Méthode	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 les status de validation.

Nom	Type	Obligatoire	Description
{customer-id}	guid	O	La valeur est un CustomerTenantId au format GUID qui vous permet de spécifier un client.
type	string	O	Type de validation status à 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 accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Champs de réponse

Champ	Type	Description	Notes
Type	Énumération	Type d’informations de validation	Mêmes données que validation-type. Le type de validation retourne le compte comme type de réponse.
Statut	Énumération	État de validation	États disponibles : Inconnu, UnderReview, Allowed, NotAllowed, Not Ready
Heure de la dernière mise à jour	chaîne	heure de la dernière status mise à jour au format UTC

Exemples de réponse

Status autorisés

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

En révision status

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

Status non autorisés

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

État Inconnu

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

Status non prêt

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

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é à l’achat

Les transactions du client sont bloquées lorsque son compte a l’un des états ci-dessous :

• UnderReview
• Non autorisé
• Unknown

Les transactions du client ne sont pas bloquées lorsqu’elles remplissent les conditions suivantes :

• Le client dispose d’un status autorisé
• Le client n’a pas de compte status