Tiempo Real
Recibe notificaciones instantáneas en cuanto cambia el estado de una verificación o transacción.
Introducción a los Webhooks
Los Webhooks son la forma más eficiente y moderna de mantener tus sistemas sincronizados con los eventos que ocurren en la plataforma de Verificamex.
¿Por qué usar Webhooks?
Sección titulada «¿Por qué usar Webhooks?»Los webhooks eliminan la necesidad de consultas innecesarias a la API, permitiendo una arquitectura reactiva y escalable.
Eficiencia
Reduce drásticamente el consumo de recursos y ancho de banda al evitar el polling repetitivo.
Automatización
Dispara flujos de trabajo automáticos en tu backend (como enviar correos o actualizar bases de datos).
Escalabilidad
Facilita la integración con servicios de terceros y arquitecturas basadas en microservicios.
¿Cómo funcionan?
Sección titulada «¿Cómo funcionan?»Implementar webhooks en tu flujo de integración es un proceso sencillo dividido en cinco etapas clave:
- Prepara tu Endpoint: Configura una URL pública en tu servidor (ej.
https://tu-api.com/webhooks/verificamex) que acepte solicitudesPOST. - Registra la URL: Al iniciar un proceso (como una sesión de verificación), incluye esta URL en los parámetros correspondientes.
- Escucha Eventos: Cuando ocurra un evento relevante (ej.
verification.completed), Verificamex enviará un payload JSON a tu URL. - Verifica la Firma: Cada envío va firmado con tu clave en los headers
webhook-id,webhook-timestampywebhook-signature. Compruébala antes de procesar el evento (ver cómo). - Responde con Éxito: Tu servidor debe procesar el evento y responder con un código de estado
200 OKpara confirmar la recepción.
Próximos Pasos
Sección titulada «Próximos Pasos»¿Listo para empezar a recibir notificaciones en tiempo real?
Guía de Uso
API Reference