Ejemplos de respuesta de Webhooks

Si incluiste el parámetro webhook_url en la solicitud POST al endpoint /verification-session, recibirás una respuesta similar a la siguiente cuando el estado de la verificación cambie:

Si incluise with_webhook_binaries = true, recibirás los binarios de los documentos relacionados al proceso de verificación en el webhook lo que puede implicar un aumento en el tamaño de la petición.

Los eventos seran enviados mediante peticiones POST

El webhook se envía cada vez que cambia el status de la sesión. Los posibles eventos que puedes recibir son:

• Cuando se inicia la verificación de una sesión (VERIFYING)
• Cuando finaliza una sesión de verificación (FINISHED)
• Cuando ocurre un error en una sesión de verificación (FAILED)

Nota

No se envía un webhook al crear la sesión: la respuesta del endpoint de creación ya te da el id y el form_url de la sesión.

Consejo

Te recomendamos el uso de https://webhook.site para que pruebes y visualices los eventos del webhook y su estructura.

Ejemplo de respuesta cuando inicia una sesión de verificación

Precaución

Si el resultado del análisis todavía no está listo, la sesión puede regresar momentáneamente a OPEN y después volver a VERIFYING, por lo que puedes recibir esos eventos más de una vez. Considera definitivo solo FINISHED o FAILED. En caso de haber habilitado with_webhook_binaries = true, recibirás los binarios en la respuesta JSON. Puedes acceder a los binarios de la siguiente forma:

data.files.data[0].binary

Como si de un arreglo se tratase.

{
    "data": {
        "object": "VerificationSession",
        "id": "a1c95531-0107-4874-9039-80a1d45b1827",
        "status": "VERIFYING",
        "result": null,
        "errors": null,
        "comments": null,
        "only_mobile_devices": false,
        "redirect_url": "https:\/\/verificamex.com",
        "webhook": "https:\/\/webhook.site\/e6bcd1db-8e7f-4a40-ae87-dd34b168df94",
        "validations": [
            "INE",
            "CURP"
        ],
        "ine_reading": null,
        "optionals": null,
        "form_url": "https:\/\/app.verificamex.com\/verification\/a1c95531-0107-4874-9039-80a1d45b1827",
        "created_at": "2026-05-15T16:01:37.000000Z",
        "updated_at": "2026-05-15T16:05:06.000000Z",
        "readable_created_at": "hace 3 minutos",
        "readable_updated_at": "hace 1 segundo"
    },
    "meta": {
        "include": "ine,renapo,files"
    }
}

Ejemplo de respuesta cuando finaliza una sesión de verificación

Precaución

Este es un ejemplo parcial de la respuesta del webhook cuando usas with_webhook_binaries = true.

{
    "data": {
        "object": "VerificationSession",
        "id": "a1d41d33-c02e-4ddb-b58c-8b5ad382321a",
        "status": "FINISHED",
        "result": 100,
        "errors": [],
        "comments": null,
        "only_mobile_devices": false,
        "redirect_url": "https:\/\/verificamex.com",
        "webhook": "https:\/\/webhook.site\/0ef2e62a-991a-4456-81df-8a178b83f1d4",
        "validations": [
            "INE",
            "CURP"
        ],
        "ine_reading": {
            "DocumentData": [
                {
                    "Type": "Surname",
                    "Name": "Apellido\/s",
                    "Value": "HERNANDEZ HERNANDEZ",
                    "Source": "MRZ"
                },
                {
                    "Type": "Name",
                    "Name": "Nombre",
                    "Value": "JUAN",
                    "Source": "MRZ"
                },
                {
                    "Type": "Sex",
                    "Name": "Sexo",
                    "Value": "H",
                    "Source": "MRZ"
                },
                {
                    "Type": "Nationality",
                    "Name": "Nacionalidad",
                    "Value": "MEX",
                    "Source": "MRZ"
                },
                {
                    "Type": "IssuingState",
                    "Name": "Pa\u00eds Emisor",
                    "Value": "MEX",
                    "Source": "MRZ"
                },
                {
                    "Type": "DateOfExpiry",
                    "Name": "Fecha de Expiraci\u00f3n",
                    "Value": "31\/12\/2032",
                    "Source": "MRZ"
                },


            .............{ejemplo parcial}................



        "ine": {
            "data": {
                "object": "IneScraping",
                "id": 67957,
                "cic": "220690985",
                "idCitizen": "2296133580472",
                "result": {
                    "data": {
                        "CIC": "220690985",
                        "N\u00famero OCR": "2296133580472",
                        "Distrito Local": "14",
                        "A\u00f1o de emisi\u00f3n": "2022",
                        "A\u00f1o de registro": "2022",
                        "Clave de elector": "CRRSLN04100430H600",
                        "Distrito Federal": "12",
                        "N\u00famero de emisi\u00f3n": "0"
                    },
                    "status": true,
                    "message": "La credencial es v\u00e1lida",
                    "maintenance": false
                },
                "created_at": "2026-05-21T00:42:39.000000Z",
                "updated_at": "2026-05-21T00:42:39.000000Z",
                "readable_created_at": "hace 32 segundos",
                "readable_updated_at": "hace 32 segundos"
            }
        },
        "renapo": {
            "data": {
                "object": "RenapoScraping",
                "id": 283608,
                "curp": "CURL041004HVZRSNA3",
                "result": {
                    "mensaje": "B\u00fasqueda exitosa por curp",
                    "codigo": "01",
                    "status": true,
                    "registros": [
                        {
                            "curp": "CURL041004HVZRSNA3",
                            "nombres": "JUAN",
                            "primerApellido": "HERNANDEZ",
                            "segundoApellido": "HERNANDEZ",
                            "sexo": "HOMBRE",
                            "fechaNacimiento": "04\/10\/2004",
                            "nacionalidad": "MEXICO",
                            "entidad": "VERACRUZ",
                            "claveEntidad": "VZ",
                            "docProbatorio": 1,
                            "docProbatorioDesc": null,
                            "statusCurp": "RCN",
                            "statusCurpDesc": null,
                            "parametro": "?curp=JUCA041004LRSRSNA2&pcurp=5E7C3AB6F7FCD699C574E05091449216&hash=a731a2a5df21e3b2b079b27a4fe62cd517a256d9",
                            "datosDocProbatorio": {
                                "entidadRegistro": "VERACRUZ",
                                "tomo": "",
                                "claveMunicipioRegistro": "193",
                                "anioRegistro": "2000",
                                "claveEntidadRegistro": "30",
                                "foja": "",
                                "numActa": "00696",
                                "libro": "",
                                "municipioRegistro": "VERACRUZ",
                                "folioCarta": null,
                                "numEntidadRegistrante": null,
                                "numRegExtranjeros": null
                            }
                        }
                    ]
                },
                "created_at": "2026-05-21T00:43:01.000000Z",
                "updated_at": "2026-05-21T00:43:01.000000Z",
                "readable_created_at": "hace 10 segundos",
                "readable_updated_at": "hace 10 segundos"
            }
        },
        "files": {
            "data": [
                {
                    "object": "VerificationFiles",
                    "id": "a1d41e5c-d533-4b7a-995c-5269941a35a7",
                    "file_type": "PDF_VERIFICATION_REPORT",
                    "mime_type": "application\/pdf",
                    "size": 232761,
                    "created_at": "2026-05-21T00:42:25.000000Z",
                    "updated_at": "2026-05-21T00:42:25.000000Z",
                    "binary": "JVBERi0xLjQNCiW0tba3DQol.........."
                },
                {
                    "object": "VerificationFiles",
                    "id": "a1d41e60-888b-4168-8951-bc915828c877",
                    "file_type": "INE_FRONT",
                    "mime_type": "image\/png",
                    "size": 331008,
                    "created_at": "2026-05-21T00:42:27.000000Z",
                    "updated_at": "2026-05-21T00:42:27.000000Z",
                    "binary": "JVBERi0xLjQNCiW0tba3DQol.........."
                    },
                {
                    "object": "VerificationFiles",
                    "id": "a1d41e60-8f64-4a3c-8d22-ec5ef168f8b5",
                    "file_type": "INE_BACK",
                    "mime_type": "image\/png",
                    "size": 363984,
                    "created_at": "2026-05-21T00:42:27.000000Z",
                    "updated_at": "2026-05-21T00:42:27.000000Z",
                    "binary": "JVBERi0xLjQNCiW0tba3DQol.........."
                },
                {
                    "object": "VerificationFiles",
                    "id": "a1d41e60-96b0-4c12-9c6a-c5946ddffb90",
                    "file_type": "FACE",
                    "mime_type": "image\/png",
                    "size": 280401,
                    "created_at": "2026-05-21T00:42:27.000000Z",
                    "updated_at": "2026-05-21T00:42:27.000000Z",
                    "binary": "JVBERi0xLjQNCiW0tba3DQol.........."
                },
                {
                    "object": "VerificationFiles",
                    "id": "a1d41e61-6d69-494f-9d30-0d918ee86e2e",
                    "file_type": "CROP_LIVE_PORTRAIT",
                    "mime_type": "image\/png",
                    "size": 52827,
                    "created_at": "2026-05-21T00:42:28.000000Z",
                    "updated_at": "2026-05-21T00:42:28.000000Z",
                    "binary": "JVBERi0xLjQNCiW0tba3DQol.........."
                },
                {
                    "object": "VerificationFiles",
                    "id": "a1d41e61-72e5-4040-9693-a150422d2eda",
                    "file_type": "CROP_DOCUMENT_PORTRAIT",
                    "mime_type": "image\/png",
                    "size": 26006,
                    "created_at": "2026-05-21T00:42:28.000000Z",
                    "updated_at": "2026-05-21T00:42:28.000000Z",
                    "binary": "JVBERi0xLjQNCiW0tba3DQol.........."
                },
                {
                    "object": "VerificationFiles",
                    "id": "a1d41e65-6dfd-484d-8443-ba03c97f4fc1",
                    "file_type": "VIDEO",
                    "mime_type": "video\/mp4",
                    "size": 868816,
                    "created_at": "2026-05-21T00:42:31.000000Z",
                    "updated_at": "2026-05-21T00:42:31.000000Z",
                    "binary": "JVBERi0xLjQNCiW0tba3DQol.........."
                },
                {
                    "object": "VerificationFiles",
                    "id": "a1d41e65-751c-4787-b5e5-77c0bfe4984e",
                    "file_type": "VIDEO",
                    "mime_type": "video\/mp4",
                    "size": 868816,
                    "created_at": "2026-05-21T00:42:31.000000Z",
                    "updated_at": "2026-05-21T00:42:31.000000Z",
                    "binary": "JVBERi0xLjQNCiW0tba3DQol.........."
                },
                {
                    "object": "VerificationFiles",
                    "id": "a1d41e77-6c23-43ab-a63e-d6062a5aee7a",
                    "file_type": "PDF_NOMINAL_LIST",
                    "mime_type": "image\/png",
                    "size": 457371,
                    "created_at": "2026-05-21T00:42:42.000000Z",
                    "updated_at": "2026-05-21T00:42:42.000000Z",
                    "binary": "JVBERi0xLjQNCiW0tba3DQol.........."
                },
                {
                    "object": "VerificationFiles",
                    "id": "a1d41e94-fe99-4252-8f8a-2c72324dd9bc",
                    "file_type": "PDF_CURP",
                    "mime_type": "application\/pdf",
                    "size": 110170,
                    "created_at": "2026-05-21T00:43:02.000000Z",
                    "updated_at": "2026-05-21T00:43:02.000000Z",
                    "binary": "JVBERi0xLjQNCiW0tba3DQol.........."
                }
            ]
        }
    },
    "meta": {
        "include": "ine,renapo,files"
    }
}