Catálogo de eventos (Short + Long)
Todos los eventos que Tonder puede enviarte, con el formato y el disparador de cada uno.
Tonder envía dos formatos de webhook según tu modo de integración. Esta página cataloga los eventos por formato; el modelo conceptual está en el Modelo de webhooks.
Formatos
| Característica | Short (API Direct · Lite SDK 2.0 · Frictionless) | Long (Hosted · SDK móvil · Legacy) |
|---|---|---|
| Estructura raíz | Campos de nivel superior | Todo dentro de data{} |
| Estado | status: Pending / Success | transaction_status: Pending / Success |
| Indicador de evento | event_type: payment_Pending | event: created / confirmed |
| Referencia de orden | client_reference | metadata.external_id / order_id |
Eventos por integración
API Direct (Short)
Los eventos llegan en event_type:
event_type | Significado |
|---|---|
payment_Pending | El pago se inició y está en proceso. |
payment_Success | El pago se completó con éxito. |
payment_Failed | El pago falló. |
En SPEI Success, el payload añade datos del remitente: sender_name, sender_clabe, sender_bank,
entre otros.
{
"id": "78eb98ef-65a8-4038-a2a0",
"operation_type": "payment",
"amount": "500",
"currency": "MXN",
"client_reference": "ORD-001",
"status": "Pending",
"payment_method_type": "SPEI",
"metadata": { "external_id": "ORD-001", "order_id": "ORD-001" },
"event_type": "payment_Pending",
"action": "MODIFY"
}Hosted Checkout (Long)
Los eventos de sesión llegan en action:
action | Significado |
|---|---|
session.created | Se creó una nueva sesión de checkout. |
session.completed | La sesión se pagó con éxito (confirma el pedido). |
session.expired | La sesión expiró sin pago. |
payment.transaction es la excepción: este evento llega en el campo event_type, no en action.
Cambió el estado de un intento de pago de la sesión. Verifica payload.event_type === 'payment.transaction', no payload.action.
Los payloads completos están en la Referencia de Hosted Checkout.
Retiros (Short)
Los retiros por API Direct usan el mismo payload plano (Short) que los pagos, con event_type en
el prefijo withdrawal_ (withdrawal_Pending, withdrawal_Success, withdrawal_Declined,
withdrawal_Failed) y transfer_method_type en lugar de payment_method_type. Detalles y ejemplos
completos en Retiros.
Usa metadata.external_id como clave de correlación —está presente en ambos formatos y en todos los
eventos.