Notificaciones de transacciones
Recibe en tiempo real información de las transacciones de tus clientes.
Introducción
Este webhook te permite recibir notificaciones instantáneas de cada transacción de tus clientes. Con esta información, puedes actuar en tiempo real y mejorar la experiencia.
Por ejemplo:
¿Una transacción es rechazada por un CVV incorrecto? Puedes enviar un mensaje automático al cliente, guiándolo directamente a los datos de su tarjeta virtual.
¿Se aprueba una transacción? Puedes notificar al cliente, confirmando el estado de su compra y dándole tranquilidad.
Eventos que te notificamos
✅ Transacciones aprobadas (approved-authorization-advice)
| EVENTO | STATUS DETAIL |
|---|---|
| Aprobada | APPROVED |
🛡️ Transacciones rechazadas por Pomelo (authorization-advice)
| EVENTO | STATUS DETAIL |
|---|---|
| Stand-In Bandera (120) | OTHER |
| Usuario Restringido | RESTRICTED_USER |
| Formato de mensajería inválido | MISSING_FIELDS |
| PIN inválido | INVALID_PIN |
| CVV inválido | INVALID_CVV |
| Fecha de expiración inválida | INVALID_EXPIRATION_DATE |
| Monto inválido | INVALID_AMOUNT |
| Transacción invalida | INVALID_TRANSACTION |
| Transacción no permitida | TRANSACTION_NOT_PERMITTED |
| Sospecha de fraude | REJECTED_FRAUD |
| Intentos máximos de PIN excedidos | PIN_TRY_LIMIT_EXCEED |
| Timeout | CLIENT_TIMEOUT |
| Cliente no disponible | CLIENT_UNAVAILABLE |
| Error interno de Pomelo | INTERNAL_ERROR |
| Tarjeta inexistente | CARD_NOT_FOUND |
| Tarjeta no configurada | CARD_NOT_CONFIGURED |
| Tarjeta deshabilitada | CARD_DISABLED |
| Tarjeta inactiva | CARD_NOT_ACTIVE |
🛡️ Transacciones rechazadas por ti (authorization-advice)
| EVENTO | STATUS DETAIL |
|---|---|
| Fondos insuficientes de tu cliente | INSUFFICIENT_FUNDS. |
| Merchant bloqueado | INVALID_MERCHANT. |
| Monto invalido de transacción por regla | INVALID_AMOUNT. |
| Error en tu sistema | SYSTEM_ERROR. |
| Otro motivo no categorizado en anteriores | OTHER. |
Implementación
Para implementar este webhook, sigue los pasos de esta documentación. Además, te invitamos a consultar toda la documentación técnica específica en nuestra API reference.
Importante:
Podrás identificar las transacciones rechazadas de las aprobadas por su tipo de evento: las transacciones aprobadas tendrán en el campo event_type: approved-authorization-advice, mientras que las rechazadas: authorization-advice.
Merchant advice code
Es una funcionalidad pensada para que los adquirentes y comercios tengan información y no realicen múltiples reintentos para procesar una operación, ahorrando costos de transacciones fallidas. Además, al obtener estos datos en tiempo real podrán contactarse con los usuarios para ofrecerles una solución para que completen la operación con éxito 😉
Casos de uso
| Fondos insuficientes | Le pedimos a los adquirentes que intenten nuevamente más tarde. Si comunicamos al cliente que la operación falló por falta de fondos, podría ingresar dinero y que el intento siguiente sea exitoso. |
| Tarjeta expirada | Le informamos a los adquirentes que no vuelvan a intentar procesar la transacción y que consigan los nuevos datos de la tarjeta. |
| Tarjeta pausada o deshabilitada | Le informamos a los adquirentes que no vuelvan a intentar procesar la transacción ya que la tarjeta no está habilitada. |
Preguntas frecuentes:
¿Qué tipo de notificaciones enviamos?
Desde el 15/9/25, enviaremos notificaciones de todas las transacciones y no únicamente de las rechazadas.
¿Se realizan reintentos de estos webhooks?
Sí. En caso de que tu respuesta sea distinta a HTTP Status 200, la notificación se re-encola y vuelve a intentar cada 10 minutos durante los siguientes 4 días.