Registros de entrega

Se registra cada intento de entrega de un webhook. Consulte el historial desde el panel o mediante la API para diagnosticar los problemas de entrega y reenviar los eventos fallidos.

Acceder a los registros

Panel: Desarrolladores → Webhooks → [Endpoint] → Registros.
API: GET /webhooks/{id}/deliveries/.
Filtros disponibles: estado (succeeded / failed), tipo de evento, período.

Campos disponibles por intento

Campo	Descripción
`id`	Identificador único del intento de entrega.
`event_type`	Tipo de evento entregado.
`event_id`	Identificador del evento de origen.
`status`	`succeeded` o `failed`.
`http_status_code`	Código HTTP devuelto por su endpoint.
`response_time_ms`	Tiempo de respuesta de su endpoint (ms).
`attempt_count`	Número del intento (1, 2, 3…).
`next_retry_at`	Fecha del próximo intento si `failed`.
`created_at`	Marca de tiempo del intento.

Reenviar una entrega fallida

Desde la ficha de un registro de fallo en el panel, haga clic en Reenviar para activar de inmediato un nuevo intento, sin esperar al siguiente ciclo de reintento automático. También puede hacerlo mediante la API: POST /webhooks/{id}/deliveries/{did}/retry/.

Depurar un fallo 500

Si su endpoint devuelve sistemáticamente 500, consulte primero los registros de aplicación de su servidor. El campo response_time_ms le indica si se trata de un timeout (cercano a 30 000 ms) o de un error de aplicación rápido. Corrija su código y después reenvíe la entrega.

¿Están bien documentados los registros de entrega?

Esquema del objeto

ResponseGET /webhooks/{id}/deliveries/

Lista paginada de los intentos de entrega de un endpoint determinado.

json

{
  "object": "list",
  "count": 42,
  "has_more": true,
  "data": [
    {
      "id": "del_xxxxxxxxxxxx",
      "object": "webhook_delivery",
      "event_type": "payment_intent.succeeded",
      "event_id": "evt_xxxx",
      "status": "succeeded",
      "http_status_code": 200,
      "response_time_ms": 145,
      "attempt_count": 1,
      "created_at": "2026-03-01T10:05:01Z"
    },
    {
      "id": "del_yyyyyyyyyyyy",
      "object": "webhook_delivery",
      "event_type": "refund.succeeded",
      "event_id": "evt_yyyy",
      "status": "failed",
      "http_status_code": 500,
      "response_time_ms": 3050,
      "attempt_count": 2,
      "next_retry_at": "2026-03-01T12:00:00Z",
      "created_at": "2026-03-01T10:05:00Z"
    }
  ]
}

Reenviar una entrega (API)

bash

curl -X POST \
  https://api.sangho.ga/v1/webhooks/wh_xxx/deliveries/del_yyy/retry/ \
  -H "Authorization: Bearer sk_prod_xxxx"

Response200 OK — Entrega reenviada

Sangho envía de inmediato un nuevo intento a su endpoint.

json

{
  "id": "del_zzzzzzzzzzzz",
  "object": "webhook_delivery",
  "event_type": "refund.succeeded",
  "status": "pending",
  "attempt_count": 3,
  "created_at": "2026-03-01T14:00:00Z"
}