Saltar al contenido principal

Webhook de notificaciones

El webhook de notificaciones permite a los clientes recibir automáticamente actualizaciones en tiempo real sobre los eventos de pago procesados ​​a través de nuestra plataforma. Al integrar este webhook, puede mantenerse informado sobre las transacciones sin la necesidad de realizar sondeos manuales.

Configuración​

Para configurar las notificaciones de eventos de pago, debe proporcionar una URL a la que nuestra plataforma pueda enviar solicitudes HTTP POST. Asegúrese de que la URL proporcionada cumpla con los siguientes requisitos:

  • Accesibilidad: La URL debe ser de acceso público y capaz de manejar solicitudes HTTP POST.
  • Manejo de datos: Su servidor debe estar preparado para procesar solicitudes entrantes que contengan datos de eventos en el formato especificado.

Detalles de la solicitud​

  • Método: POST

Datos relevantes enviados en el webhook​

Los datos se enviarán en formato JSON con la siguiente estructura:

{
    "transactionDate": "2025-01-21 08:16:58",
    "transactionStatus": "canceled",
    "transactionId": "fdb5e7bc-XXXX-XXXX-XXXX-97259408af0d",
    "totalAmount": 53.75,
    "paymentMethod": "cash",
    "email": "testuser@gmail.com",
    "numeroOrden": "n/a",
    "merchantId": ""
}

Respuesta esperada del webhook

El servidor del cliente debe responder con un código de estado 200 OK para confirmar la correcta recepción del mensaje. Cualquier otro código de estado se considerará un error de entrega y se volverá a intentar el envío del mensaje.

Ejemplo de una solicitud POST​

La estructura JSON anterior se enviará como el cuerpo de una solicitud HTTP POST a la URL configurada. A continuación, se muestra un ejemplo de cómo se verá la solicitud:

POST /webhook-endpoint HTTP/1.1
Host: your-website.com
Content-Type: application/json

{
    "transactionDate": "2025-01-21 08:16:58",
    "transactionStatus": "canceled",
    "transactionId": "fdb5e7bc-XXXX-XXXX-XXXX-97259408af0d",
    "totalAmount": 53.75,
    "paymentMethod": "cash",
    "email": "testuser@gmail.com",
    "numeroOrden": "n/a",
    "merchantId": ""
}

Preguntas frecuentes​

  • ¿Qué sucede si mi servidor no está disponible para recibir notificaciones? Si nuestra plataforma no recibe una respuesta exitosa (200 OK) de su servidor, volveremos a intentar enviar la notificación hasta tres veces. Si todos los reintentos fallan, el evento se marcará como imposible de entregar y se enviará una notificación por correo electrónico al correo electrónico de contacto designado para su cuenta.

Recomendamos implementar un registro y monitoreo sólidos en su servidor para identificar y resolver problemas potenciales rápidamente.