Detalle de la validación

Este endpoint retorna todos los intentos de validación de identidad realizados por un firmante, incluyendo el estado, el motivo de falla (si lo hubiera) y la información extraída del documento.

GET https://api.zapsign.com.br/api/v1/signer-verification-details/{{signer_token}}/

Header

Nombre	Tipo	Descripción
Authorization*	string	API token prefijo con la palabra "Bearer". Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23

Response

200 - Exitoso

{
    "token": "0abe0677-72d7-4816-9ba8-317145d387ea",
    "selfie_validation_type": "identity-verification-global",
    "validations": [
        {
            "type": "Identity verification",
            "validation_number": "cd461e6a-a5d5-4bd7-8e50-20263c9f64a9",
            "status": "success",
            "reason": "",
            "created_at": "2025-06-05T18:51:26.286366Z",
            "document_photo_url": "https://zapsign.s3.amazonaws.com",
            "document_verse_photo_url": "https://zapsign.s3.amazonaws.com/",
            "selfie_photo_url": "",
            "document_ocr": {
                "process_id": "cd461e6a-a5d5-4bd7-8e50-20263c9f64a9",
                "name": "MARIA",
                "last_name": "SOUZA",
                "document_type": "ID_CARD",
                "document_number": "11111111",
                "date_of_birth": "1980-01-01",
                "document_country": "BR"
            }
        },
        {
            "type": "Name validation",
            "status": "success",
            "reason": "",
            "created_at": "2025-06-05T18:51:26.286366Z"
        }
    ]
}

404 - Not found

{
    "error": "Signer not found"
}

Sobre el resultado de la validación

Este endpoint permite consultar el resultado del proceso de validación definido en el parámetro selfie_validation_type. Cada tipo de validación posee etapas específicas que verifican diferentes aspectos del documento y/o del rostro del firmante.

Dentro de cada etapa existen sub-validaciones, y para cada una de ellas la respuesta del endpoint retorna:

• El estado (éxito o fallo).

• El campo reason, que explica el motivo del fallo, cuando aplica.

A continuación, se detallan los diferentes tipos de validación disponibles y sus etapas correspondientes:

---

liveness-document-match

Este método realiza dos validaciones principales:

• Document recognition: verifica si la foto enviada del frente del documento realmente corresponde a un documento de identidad y si contiene una foto.

  Importante: no aplica modelos avanzados de fraude ni identifica casos de “foto de foto”.

• Face match: compara el video pasivo del rostro del firmante con la foto del documento presentado, garantizando que se trata de la misma persona. El resultado incluye la URL de la foto de rostro capturada.

---

face-match-and-datavalid

Disponible solo para Brasil – CNH. Este método realiza una única validación:

• Compara el nombre y CPF con las bases del Serpro, además de verificar si coinciden con la persona identificada en el video pasivo realizado durante la firma.

---

identity-verification-global

Este método realiza tres validaciones complementarias:

• Identity verification: valida que el documento sea real utilizando modelos de detección de fraude y retorna los datos extraídos automáticamente (OCR), incluyendo:

  • name

  • last_name

  • document_type

  • document_number

  • date_of_birth

  • document_country

• Name validation: compara el nombre extraído del documento con el nombre informado por el firmante. La validación se considera aprobada si la similitud es mayor al 75%.

• Validación de CPF (Brasil): cuando el documento es de Brasil y contiene CPF, se realiza una verificación automática en la Receita Federal.

---

identity-verification

Disponible para Colombia, México, Chile y Perú. Este método realiza dos validaciones:

• Identity verification: valida que el documento sea real con modelos de fraude, realiza consulta en bases de datos del gobierno y garantiza que el video pasivo corresponda a la misma persona del documento.

• Name validation: compara el nombre extraído del documento con el nombre informado por el firmante, aplicando la misma lógica de similitud usada en el método identity-verification-global.