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

Los posibles eventos que puedes recibir en el webhook de las sesiones de verificación son:

• Cuando se crea una nueva sesión de verificación
• Cuando se inicia una nueva sesión de verificación
• Cuando finaliza una sesión de verificación
• Cuando ocurre un error en una sesión de verificació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 se crea una sesión de verificación

{
    "data": {
        "object": "VerificationSession",
        "id": "a1c95531-0107-4874-9039-80a1d45b1827",
        "status": "OPEN",
        "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:01:38.000000Z",
        "readable_created_at": "hace 1 segundo",
        "readable_updated_at": "hace 1 segundo"
    },
    "meta": {
        "include": "ine,renapo,files"
    }
}

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

Precaución

El webhook te notificara el paso a paso sobre el proceso de verificación de identidad. Por lo que recibirás múltiples eventos VERIFYING. 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"
    }
}