Todos los productos
Search
Centro de documentos

ID Verification:CheckResult

Última actualización: Oct 26, 2026

Obtiene el resultado de una verificación de identidad por NFC. Llame a esta operación desde su servidor después de recibir una notificación de callback.

API reference

  • Nombre de la operación: CheckResult

  • Método de solicitud: HTTPS POST

  • Description: Cuando el lado del servidor recibe un callback que indica que la autenticación finalizó, llame a esta API para obtener el estado y la información de autenticación correspondientes. Este callback se envía cuando el código de resultado del cliente es 1001 o 1002. Para más información, consulte Native SDK client result codes and sub-codes.

    Importante

    El servicio ID Verification almacena los resultados de verificación durante 30 días de forma predeterminada. Obténgalos dentro de este periodo, ya que se eliminan automáticamente después.

  • Límite de QPS: cada API tiene su propio límite de QPS. Para más información, consulte QPS limits of ID Verification server-side APIs.

  • Endpoints del servicio:

    Nota
    • Ventajas del acceso por red interna: una red interna es una red de comunicación privada que conecta los productos de Alibaba Cloud dentro de la misma región. Si su servidor de aplicaciones está desplegado en la misma región, utilice el endpoint interno para acceder al servicio ID Verification y mejorar la seguridad y la estabilidad.

    • Optimización del acceso desde el extranjero: los entornos de red internacionales pueden ser complejos. Consulte Optimize server network latency para ajustar su integración y reducir la latencia de red y los errores en las solicitudes.

    Asia Pacific SE 1 (Singapore)

    • Endpoint público: cloudauth-intl.ap-southeast-1.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    Asia Pacific SE 5 (Jakarta)

    • Endpoint público: cloudauth-intl.ap-southeast-5.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

    China (Hong Kong)

    • Endpoint público: cloudauth-intl.cn-hongkong.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    Asia Pacific SE 3 (Kuala Lumpur)

    • Endpoint público: cloudauth-intl.ap-southeast-3.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com

Depuración e integración en línea

Nota

Antes de depurar e integrar, lea el documento Use OpenAPI para aprender cómo llamar a las API en la plataforma OpenAPI y obtener el SDK.

Puede ejecutar directamente esta operación en OpenAPI Explorer para probarla y generar ejemplos de código del SDK para esta operación.Ejemplos de código del SDK.

Parámetros de solicitud

Nombre

Tipo

Obligatorio

Descripción

Valor de ejemplo

MerchantBizId

String

Sí

Identificador de negocio único para la resolución de problemas. Admite hasta 32 caracteres alfanuméricos.

Asegúrese de que sea único en todo su negocio.

Nota

Alibaba Cloud no valida la unicidad.

Asegúrese de que sea único para garantizar la trazabilidad.

e0c34a77f5ac40a5aa5e6ed20c35****

TransactionId

String

Sí

El identificador de autenticación único que devuelve una llamada exitosa a la API init. Para evitar alteraciones, obtenga siempre este valor desde el almacenamiento de su servidor y no confíe en el valor enviado desde el cliente.

hksb7ba1b28130d24e015d6****

IsReturnImage

String

No

Indica si se devuelve la imagen de verificación:

  • Y : sí

  • N: no (valor predeterminado)

Y

Parámetros de respuesta

Nombre

Tipo

Descripción

Ejemplo

HTTP Status Code

Integer

Código de estado HTTP

200

HTTP Body

RequestId

String

ID de la solicitud

130A2C10-B9EE-4D84-88E3-5384FF03****

Code

String

Código de retorno. Para más información, consulte Server-side HTTP status codes.

Success

Message

String

Descripción detallada del código de retorno.

success

Result.Passed

String

Resultado final de la verificación:

  • Y: aprobado

  • N: con errores

Y

Result.SubCode

String

Descripción del resultado de verificación. SubCode error codes for ResultObject.

200

Result.ExtIdInfo

String

Información del documento leída por NFC.

ExtIdInfo.

{
  "nfcIdImage": "<ImageBase64Code>",
  "nfcIdInfo": {
    "passportNo": "EP1875674",
    "expiryDate": "16-02-2035",
    "nationality": "CHN",
    "surname": "WU",
    "givenname": "DONGSHENG",
    "countryCode": "CHN",
    "sex": "M",
    "birthDate": "04-12-1991"
    }
}

Códigos de error SubCode para ResultObject

Nota

El SubCode se devuelve según las distintas soluciones de producto o métodos de integración. Para más detalles, consulte la siguiente tabla.

Solución aplicable

Código de error

¿Se factura el registro de autenticación?

Descripción y posibles causas

General

200

Sí

La autenticación se aprobó.

  • Integración exclusiva del lado del servidor de ID_OCR (DocOcr)

  • ID_OCR_MAX

211

Sí

La calidad o la resolución de la imagen del certificado no cumple los requisitos, o bien la imagen está incompleta. Asegúrese de que la fotografía del lado con retrato del certificado sea nítida, tenga una exposición normal, esté completa sin obstrucciones y no presente desviaciones de ángulo significativas.

  • Integración de ID_OCR App (SDK)

  • Integración de ID_OCR Web (SDK)

  • ID_OCR_MAX

212

Sí

La detección antifalsificación del certificado indica riesgo. Es posible que existan operaciones de alto riesgo, como volver a fotografiar, alterar o fotocopiar el documento.

  • Integración exclusiva del lado del servidor de ID_OCR (DocOcr)

  • ID_OCR_MAX

213

Sí

No se detectó el tipo de certificado especificado (modo de reconocimiento) o no fue posible identificarlo (modo de clasificación).

Se recomienda cargar una imagen del certificado nítida, completa y con un ángulo normal.

ExtIdInfo

Nombre

Tipo

Descripción

Ejemplo

nfcIdImage

String

Fotografía del rostro codificada en Base64, leída del documento mediante NFC.

Se devuelve únicamente cuando isReturnImage es Y y la verificación se aprueba.

base64

nfcIdInfo

String

Campos del documento leídos mediante NFC.

Compatible solo con pasaportes globales. Los detalles de los campos se muestran en la siguiente tabla.

Pasaporte electrónico

Nota

Este tipo de documento lee la zona de lectura mecánica (MRZ) de los pasaportes electrónicos compatibles con la ICAO. Extraer un conjunto estándar de campos garantiza la compatibilidad entre pasaportes de distintos países, los cuales suelen tener formatos diferentes.

Parameter

Type

Description

surname

String

Apellido en caracteres latinos obtenido de la MRZ.

givenname

String

Nombre de pila en caracteres latinos obtenido de la MRZ.

sex

String

Sexo, devuelto como F o M.

birthDate

String

Fecha de nacimiento, en formato yyyy-mm-dd.

passportNo

String

Número de pasaporte

nationality

String

Nacionalidad, representada por un código de país de 3 letras.

expiryDate

String

Fecha de vencimiento, en formato yyyy-mm-dd.

countryCode

String

Código de país de la autoridad emisora.

(código de país de 3 letras)