Recuperar el estado de validación de un cliente

Un asociado puede recuperar el estado de una validación del cliente a petición.

Requisitos previos

• Credenciales establecidas como se describe en Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.

• Un identificador de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners si selecciona el área de trabajo Clientes , el cliente de la lista de clientes y, a continuación, cuenta. En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Información de la cuenta de cliente . El identificador de Microsoft es el mismo que el identificador de cliente (customer-tenant-id).

C#

Para recuperar el estado de validación de un cliente para su cuenta, cree primero una enumeración que represente validationType que se va a recuperar. A continuación, llame al método IAggregatePartner.Customers.ById con el identificador de cliente. A continuación, use la propiedad ValidationStatus para recuperar una interfaz IValidationStatus . Por último, llame a GetValidationStatus() o GetValidationStatusAsync() con la variable de enumeración de tipo de validación como parámetro de entrada.

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

Ejemplo: Aplicación de ejemplo de consola. Project: Clase SdkSamples: GetValidationStatus.cs

Solicitud REST

Sintaxis de la solicitud

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

Parámetro de URI

Use el siguiente parámetro de consulta para especificar el cliente para el que está recuperando el estado de validación.

Nombre	Tipo	Obligatorio	Descripción
{customer-id}	guid	Y	El valor es un GUID con formato CustomerTenantId que permite especificar un cliente.
tipo	string	Y	Tipo de estado de validación que se va a recuperar.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Respuesta REST

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.

Campos de respuesta

Campo	Tipo	Descripción	Notas
Tipo	Enumeración	Tipo de información de validación	Los mismos datos que el tipo de validación. El tipo de validación devuelve la cuenta como el tipo de respuesta.
Estado	Enumeración	Estado de validación	Estados disponibles: Unknown, UnderReview, Allowed, NotAllowed, Not Ready
Hora de actualización más reciente	string	hora de la última actualización de estado en UTC

Ejemplos de respuesta

Estado permitido

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

En estado de revisión

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

Estado NotAllowed

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

Estado Desconocido

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

Estado No listo

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

Error 404 no 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"

Elegibilidad de compra

Las transacciones del cliente se bloquearán cuando su cuenta tenga cualquiera de los estados siguientes:

• UnderReview
• No permitidos
• Desconocido

Las transacciones del cliente no se bloquearán cuando cumplan las condiciones siguientes:

• El cliente tiene el estado Permitido
• El cliente no tiene el estado de la cuenta