Recuperare lo stato di convalida di un cliente

Articolo
10/07/2024

Un partner può recuperare lo stato di una convalida del cliente su richiesta.

Prerequisiti

Credenziali stabilite come descritto in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con le credenziali app + utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).

C#

Per recuperare lo stato di convalida di un cliente per il proprio account, creare prima di tutto un'enumerazione che rappresenta validationType da recuperare. Chiamare quindi il metodo IAggregatePartner.Customers.ById con l'identificatore del cliente. Usare quindi la proprietà ValidationStatus per recuperare un'interfaccia IValidationStatus. Infine, chiamare GetValidationStatus() o GetValidationStatusAsync() con la variabile enum del tipo di convalida come parametro di input.

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

Esempio: App di esempio console. Progetto: Classe SdkSamples: GetValidationStatus.cs

Richiesta REST

Sintassi della richiesta

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

Parametro URI

Usare il parametro di query seguente per specificare il cliente per cui si sta recuperando lo stato di convalida.

Nome	Digita	Obbligatorio	Descrizione
{customer-id}	guid	Y	Il valore è un GUID formattato CustomerTenantId che consente di specificare un cliente.
type	string	Y	Tipo di stato di convalida da recuperare.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Risposta REST

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Campi di risposta

Campo	Tipo	Description	Note
Type	Enumerazione	Tipo di informazioni di convalida	Stessi dati del tipo di convalida. Il tipo di convalida restituisce l'account come tipo di risposta.
Stato	string	Stato convalida	Stati disponibili: Sconosciuto, UnderReview, Allowed, NotAllowed, Not Ready
Ora dell'aggiornamento più recente	string	ora dell'ultimo aggiornamento dello stato in formato UTC	L'ora di data non viene più popolata e sarà una stringa vuota.

Esempi di risposta

Stato consentito

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

In stato di revisione

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

Stato NotAllowed

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

Stato sconosciuto

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

Stato Non pronto

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

Errore 404 non trovato

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

Idoneità per l'acquisto

Le transazioni del cliente vengono bloccate se il proprio account ha uno degli stati seguenti:

UnderReview
NotAllowed
Sconosciuto

Le transazioni del cliente non vengono bloccate quando soddisfano le condizioni seguenti:

Il cliente ha lo stato Consentito
Il cliente non ha lo stato dell'account

Condividi tramite