Configuración de webhooks

¿Qué es un webhook?

Un webhook es un mensaje automatizado que se envía a una aplicación externa cuando ocurre un evento. A nivel más técnico, un webhook es una devolución de llamada HTTP o una petición HTTP POST generada por la notificación de un evento.

Configuración del webhook en el portal del comercio

Para configurar un Webhook, primero debes crear un endpoint en el que se enviarán las notificaciones. Este endpoint debe ser una URL que acepte peticiones HTTP POST.

Ingresa al portal en el menú Desarrolladores, en la pestaña de Webhooks. Posteriormente para configurar un endpoint, selecciona la opción Add Endpoint.

Debes seguir los pasos que se muestran a continuación:

Agrega la URL de tu endpoint, opcionalmente, puedes anexar una descripción de tu endpoint.
Selecciona el evento que se notificará al endpoint en la opción Subscribe to events, debes de elegir al menos un evento a notificar.

Una vez registrado podrás probar el webhook en la pestaña Testing con los eventos disponibles, en las cuales se enviará una notificación con datos de prueba.

Para verificar los mensajes que envía OrkestaPay al webhook que se ha indicado, debes de utilizar el Webhook Signing Secret que te proporcionamos y seguir nuestra guía de Verificación de mensajes.

Logs

En la sección de Logs, se listan las notificaciones que se han enviado al webhook configurado.

En cada notificación se muestra los detalles del mensaje, los intentos de la notificación y los detalles de las respuestas de cada notificación.

Pruebas

Cabe mencionar que la URL que se configure en el webhook, debe estar expuesta a internet para poder notificarle los mensajes.

Recomendamos el uso de la herramienta de ngrok para sus pruebas locales.