Partilhar via


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