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)

EVENTOSTATUS DETAIL
AprobadaAPPROVED

🛡️ Transacciones rechazadas por Pomelo (authorization-advice)

EVENTOSTATUS DETAIL
Stand-In Bandera (120)OTHER
Usuario RestringidoRESTRICTED_USER
Formato de mensajería inválidoMISSING_FIELDS
PIN inválidoINVALID_PIN
CVV inválidoINVALID_CVV
Fecha de expiración inválidaINVALID_EXPIRATION_DATE
Monto inválidoINVALID_AMOUNT
Transacción invalidaINVALID_TRANSACTION
Transacción no permitidaTRANSACTION_NOT_PERMITTED
Sospecha de fraudeREJECTED_FRAUD
Intentos máximos de PIN excedidosPIN_TRY_LIMIT_EXCEED
TimeoutCLIENT_TIMEOUT
Cliente no disponibleCLIENT_UNAVAILABLE
Error interno de PomeloINTERNAL_ERROR
Tarjeta inexistenteCARD_NOT_FOUND
Tarjeta no configuradaCARD_NOT_CONFIGURED
Tarjeta deshabilitadaCARD_DISABLED
Tarjeta inactivaCARD_NOT_ACTIVE

🛡️ Transacciones rechazadas por ti (authorization-advice)

EVENTOSTATUS DETAIL
Fondos insuficientes de tu clienteINSUFFICIENT_FUNDS.
Merchant bloqueadoINVALID_MERCHANT.
Monto invalido de transacción por reglaINVALID_AMOUNT.
Error en tu sistemaSYSTEM_ERROR.
Otro motivo no categorizado en anterioresOTHER.

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 insuficientesLe 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 expiradaLe 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 deshabilitadaLe 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.

¿Te resultó útil el contenido de esta documentación?