Webhook de Notificaciones – Borderless API

Usá nuestro webhook de notificaciones para recibir actualizaciones en tiempo real sobre el estado de los pagos realizados mediante la API de Borderless .

🚀 ¿Cómo habilitar las notificaciones?

Para comenzar a recibir notificaciones de cambios de estado en tus transacciones, seguí estos pasos:

1. Exponer un endpoint HTTPS en tus servidores.
2. Compartir con nosotros la URL de tu endpoint para que podamos configurarlo.
3. Procesar las notificaciones recibidas con tu lógica de negocio.

📥 Requisitos del endpoint

Las notificaciones se envían como solicitudes HTTP POST al endpoint que nos indiques. Asegurate de cumplir con los siguientes requisitos:

• El endpoint debe estar disponible mediante HTTPS.
• Debe responder con un código HTTP 200 para confirmar la recepción.
• Es posible que necesites configurar tu firewall o WAF para aceptar solicitudes desde nuestras IPs: 107.23.220.24, 23.22.34.57 y 3.83.0.169

🚧

Reintento de notificaciones

Si respondes con un codigo fuera del rango 2XX o demoras mas de 5 segundos en responder, volveremos a intentar luego de un tiempo. Deberas encargarte de deduplicar eventos usando el identificador del mismo.

⚙️ Configuración del webhook

Una vez que hayas expuesto tu endpoint, compartinos la URL y nosotros nos encargaremos de configurarlo.

Te enviaremos un verify_token que deberás usar para validar la autenticidad de cada notificación recibida.

📌 Procesamiento de notificaciones

Cuando recibas una notificación, seguí estos pasos:

1. ✅ Verificar elverify_token incluido en la notificación.
2. 🗃️ Guardar el contenido en tu base de datos para trazabilidad.
3. 🔁 Responder con un código HTTP 2XX (idealmente 200) para evitar reintentos.
4. 🧠 Aplicar la lógica de negocio necesaria según el tipo de evento.