Notificaciones (Webhooks)
Descripción
MetrePay envía notificaciones automáticas al sistema del comercio cuando ocurren eventos relevantes, como la confirmación de un pago o la finalización de una suscripción. Esto permite mantener sincronizados los estados de cuenta sin intervención manual.
Eventos Disponibles
| Evento | Descripción |
|---|---|
| Pago exitoso | Se notifica cuando un cliente completa un pago de forma satisfactoria. |
| Suscripción finalizada | Se notifica cuando una suscripción de débito automático llega a su fin (todas las cuotas fueron procesadas). |
Configuración
La configuración de notificaciones se realiza de forma autogestionada desde el portal web del comercio, en la sección Configuración / Notificaciones.
Para cada evento se debe indicar:
- La URL del endpoint que recibirá las notificaciones.
- El método HTTP a utilizar (POST, PUT o PATCH).
Opcionalmente, se pueden agregar capas de seguridad:
- Autenticación por header personalizado.
- Autenticación básica (usuario y contraseña).
Datos Incluidos en la Notificación
Cada notificación de pago incluye información del ticket, monto, moneda, concepto, identificadores del cliente y datos de contacto. Esto permite al comercio actualizar sus registros internos de forma automática.
Información de Conciliación
Para comercios con el parámetro de conciliaciones activado, la notificación incluye adicionalmente:
- La procesadora de origen de la transacción (Bancard o Bepsa).
- El tipo de tarjeta utilizada (crédito o débito).
Esta información es relevante para la conciliación bancaria, dado que las acreditaciones se realizan de forma separada por procesadora y tipo de tarjeta.
Requisitos Técnicos
El comercio debe implementar un webservice (endpoint) que:
- Acepte peticiones HTTP en el método configurado.
- Procese el cuerpo JSON de la notificación.
- Responda con un código HTTP de éxito (200).
Relación con la API
La documentación técnica completa del formato de notificaciones, campos y ejemplos se encuentra en la sección de Webhooks de la API.