Notificaciones de presentaciones
Recibe alertas en tiempo real cuando procesamos cada presentación.
Introducción
Al configurar este webhook, te enviaremos una notificación cada vez que una presentación llegue a estado APPROVED o IN_REVIEW. Eso te servirá para automatizar conciliaciones, auditar pagos y mantener trazabilidad.
Si la transacción original fue financiada en cuotas, te indicaremos cuál es la cuota presentada en el campo installments_data.current_installment.
Revisa nuestra documentación sobre Cómo configurar los webhooks.
Información sobre los campos
Estos son los principales campos que recibirás y deberás procesar desde el webhook:
| CAMPO | DESCRIPCIÓN |
|---|---|
| idempotency_key | Clave única para evitar duplicados. |
| event_detail.type | Hace referencia al tipo de evento, que en este caso siempre será PRESENTMENT |
| event_detail.status | El estado de la presentación puede ser APPROVED o IN_REVIEW. Si está IN_REVIEW significa que lo estamos revisando y que en los siguientes 7 días puede tener un ajuste. |
| public_id | ID único de la presentación en Pomelo. |
| original_transaction_data.transaction_id | ID de la transacción original. |
| associated_transactions | Identificadores de transacciones relacionadas. |
| amounts.transaction_amount, settlement_amount, net_debt_amount, interchange_fee, tax_amount | Montos que te pueden servir para conciliar con la liquidación de la marca. |
| reconciliation_date | Fechas que te pueden servir para conciliar con la liquidación diaria que te enviamos o la de la marca (en caso que seas miembro principal). |
| installments_data.current_installment | Número de cuota que se está presentando (si aplica). |
Implementación
Para activar el webhook de presentaciones, escríbenos desde Dashboard o contacta a tu representante de Custumer success.
Recomendaciones:
- Almacena el payload completo por temas de auditoría y futuras actualizaciones de esquema.
- Lleva un registro de event_detail.public_id o reconciliation_date para asegurar el orden cronológico de operaciones.
Para más información técnica, visita esta documentación.
¿Para qué me sirve el webhook de presentaciones?
| 📄Conciliación automática | Integra los datos para cuadrar tus registros con lo que presentó la marca y luego se te va a liquidar. Es similar al reporte de presentaciones pero en tiempo real. |
| 🔍Auditoría | Guarda trazabilidad de cuándo y cómo se presentó cada transacción. |
Esquema de reintentos
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.