Webhooks

Registro de eventos

Cada webhook que Tonder envió a tus endpoints, con cada intento y la respuesta de tu servidor — busca, filtra y reenvía desde Desarrolladores › Eventos.

Desarrolladores › Eventos muestra cada webhook que Tonder envió a tus endpoints, con todos sus intentos de entrega: qué se envió, qué respondió tu servidor y cuándo. Los eventos se conservan 60 días.

Webhooks 2.0 se habilita por cuenta. Si en Desarrolladores de tu dashboard no aparece la pestaña Eventos, tu cuenta está en la versión anterior: pide a tu contacto de Tonder que la habilite.

El registro de eventos en Desarrolladores › Eventos

Encuentra un evento

  • Pestañas por estado, cada una con su conteo: Todos, Entregados, Reintentando, Fallidos.
  • Filtros: tipo de evento, endpoint y rango de fechas —los últimos 7 días por defecto, hasta 60.
  • Búsqueda por el id de la transacción, tu referencia (client_reference o metadata.external_id), el id de transacción de Tonder, el id del evento (evt_…) o el de la entrega (dlv_…). Busca en todo el historial disponible, sin importar el rango de fechas.
  • Páginas: Anterior / Siguiente, 25 eventos por página. Con filtros, alguna página puede traer menos de 25; sigue con Siguiente.
ColumnaQué muestra
FechaCuándo se creó el evento.
Tipo de eventoEl event_type, por ejemplo payment_Success.
ID del recursoLa transacción o el retiro al que pertenece el evento.
EndpointEl endpoint al que se envió.
IntentosIntentos hasta ahora sobre los 6 automáticos, por ejemplo 4/6.
Última respuestaEl último código HTTP de tu servidor.
EstadoEntregado, Reintentando o Fallido.

Cuando el periodo tiene eventos Fallidos, un aviso sobre la tabla indica cuántos y ofrece Reintentar todos.

Detalle del evento

Haz clic en un evento para abrir su detalle:

CampoQué muestra
ID del eventoEl identificador del evento (evt_…).
ID del recursoLa transacción o el retiro.
EndpointA dónde se envió.
Formato del payloadShort o Long.
IntentosCada intento con su hora, el código de respuesta de tu servidor, la duración y los primeros 2 KB del cuerpo de la respuesta. Un intento que lanzaste tú aparece marcado como manual.
PayloadLo que envió Tonder.

Mientras un evento se reintenta, el panel también muestra cuándo será el próximo intento automático.

El detalle de un evento

Reenvía

Reenviar evento en el detalle vuelve a enviar el evento; Reintentar todos reenvía todos los eventos Fallidos que coinciden con el filtro actual. Las reglas —qué pasa con los intentos automáticos que quedan y cuándo se rechaza un reenvío— están en Entrega y reintentos.

Desde una transacción o un retiro

En Transacciones o Retiros, abre el detalle de un registro: la sección Eventos de webhook lista los webhooks enviados por ese registro, con el evento, el endpoint, la respuesta de tu servidor y el estado. Cada uno abre su detalle en el registro de eventos, y un enlace junto al título de la sección te lleva al registro.

Eventos de webhook en el detalle de una transacción

Por API

GET /v1/deliveries lista las entregas con los mismos filtros y la misma búsqueda, GET /v1/deliveries/{id} devuelve una con todos sus intentos, y dos operaciones retry reenvían —ver API de webhooks.

Siguientes pasos

¿Te resultó útil esta página?

En esta página