Recuperar o status de validação de um cliente
Um parceiro pode recuperar o status de uma validação do cliente sob demanda.
Pré-requisitos
Credenciais estabelecidas, conforme descrito na autenticação do Partner Center. Este cenário suporta autenticação apenas com credenciais App+User.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Partner Center selecionando a área de trabalho Clientes e, em seguida, o cliente na lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é a mesma que a ID do cliente (customer-tenant-id).
C#
Para recuperar o status de validação de um cliente para sua conta, primeiro crie um enum representando o ValidationType a ser recuperado. Em seguida, chame o método IAggregatePartner.Customers.ById com o identificador do cliente. Em seguida, use a propriedade ValidationStatus para recuperar uma interface IValidationStatus. Finalmente, chame GetValidationStatus()
ou GetValidationStatusAsync()
com a variável enum do tipo de validação como um parâmetro de entrada.
var validationTypeToFetch = ValidationType.Account;
var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).ValidationStatus.GetValidationStatus(validationTypeToFetch);
Exemplo: Aplicativo de exemplo de console. Projeto: SdkSamples Classe: GetValidationStatus.cs
Pedido REST
Sintaxe da solicitação
Método | URI |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/validationStatus?type=account |
Parâmetro URI
Use o parâmetro de consulta a seguir para especificar o cliente para o qual você está recuperando o status de validação.
Nome | Type | Obrigatório | Description |
---|---|---|---|
{ID do cliente} | guid | Y | O valor é um GUID formatado CustomerTenantId que permite especificar um cliente. |
tipo | string | Y | O tipo de status de validação a ser recuperado. |
Cabeçalhos do pedido
Para obter mais informações, consulte Cabeçalhos REST do Partner Center.
Resposta do REST
Cada resposta vem com um código de status HTTP que indica sucesso ou falha e outras informações de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.
Campos de resposta
Campo | Tipo | Description | Notas |
---|---|---|---|
Type | Enumeração | Tipo de informação de validação | Os mesmos dados que o tipo de validação. O tipo de validação retorna conta como o tipo de resposta. |
Estado | string | Estado de validação | Status disponíveis: Unknown, UnderReview, Allowed, NotAllowed, Not Ready |
Hora da última atualização | string | hora da última atualização de status em UTC | A hora da data não é mais preenchida e será uma cadeia de caracteres vazia. |
Exemplos de respostas
Estado permitido
{
"type": "account",
"status": "Allowed",
"lastUpdateDateTime": ""
}
Em estado de revisão
{
"type": "account",
"status": "UnderReview",
"lastUpdateDateTime": ""
}
Estado NotAllowed
{
"type": "account",
"status": "NotAllowed",
"lastUpdateDateTime": ""
}
Estado desconhecido
{
"type": "account",
"status": "Unknown",
"lastUpdateDateTime": ""
}
Estado Não Pronto
{
"type": "account",
"status": "Not Ready",
"lastUpdateDateTime": ""
}
404 erro não encontrado
{
"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"
Elegibilidade de compra
As transações do cliente são bloqueadas se a sua conta tiver algum dos estados abaixo:
- Subavaliação
- Não permitido
- Desconhecido
As transações do cliente não são bloqueadas quando atendem às seguintes condições:
- O cliente tem um status Permitido
- O cliente não tem o status da conta