Testar, listar e reenviar

1. Dispare um evento de teste

curl -X POST https://api.oripaysolutions.com.br/v1/webhook-endpoint/test \
  -H "Authorization: Bearer $ORIPAY_API_KEY"

Enviamos um webhook.test real, assinado como qualquer outro evento, e respondemos com o resultado da entrega:

{
  "event_id": "evt_0c1d2e3f-...",
  "delivery": {
    "id": "dlv_4a5b6c7d-...",
    "attempt": 1,
    "status": "delivered",
    "response_status": 200,
    "duration_ms": 182,
    "error": null,
    "attempted_at": "2026-10-28T13:30:00Z"
  }
}

Se status vier failed, o campo error diz o motivo: timeout, tls_error, invalid_destination (o domínio não resolve ou aponta para um endereço privado), redirect_not_followed, connection_refused, invalid_url, network_error ou http_<código>. O webhook.test não tem retentativa automática. Sem webhook cadastrado: 404 not_found. Não precisa de Idempotency-Key.

2. Liste os eventos

curl "https://api.oripaysolutions.com.br/v1/events?delivery_status=failed&created_from=2026-10-28T00:00:00Z" \
  -H "Authorization: Bearer $ORIPAY_API_KEY"

Filtro	Valores
`type`	Qualquer evento, ex. `charge.paid`
`limit` / `cursor`	Paginação: 1 a 100 (padrão 50), passe `cursor=<next_cursor>` até vir `null`
`delivery_status`	`pending`, `delivered`, `failed`
`resource_id`	Eventos de um recurso, ex. de uma cobrança
`external_id`	Eventos de um `external_id` seu
`created_from` / `created_to`	Período (UTC)

Cada evento traz id, type, created_at, delivery_status, attempts (tentativas feitas) e data. Os eventos ficam disponíveis por 30 dias.

3. Veja cada tentativa de entrega

curl https://api.oripaysolutions.com.br/v1/events/{id}/deliveries \
  -H "Authorization: Bearer $ORIPAY_API_KEY"

{
  "data": [
    { "id": "dlv_...", "attempt": 1, "status": "failed", "response_status": 500, "duration_ms": 10000, "error": "timeout", "attempted_at": "2026-10-28T13:05:13Z" },
    { "id": "dlv_...", "attempt": 2, "status": "delivered", "response_status": 200, "duration_ms": 95, "error": null, "attempted_at": "2026-10-28T13:06:14Z" }
  ]
}

4. Reenvie

curl -X POST https://api.oripaysolutions.com.br/v1/events/{id}/resend \
  -H "Authorization: Bearer $ORIPAY_API_KEY"

Resposta 202: o evento voltou para a fila e sai na próxima rodada de entregas (cerca de 10 s).

{ "event_id": "evt_9f8e7d6c-5b4a-4321-8fed-cba987654321", "status": "queued" }

Reenvia o mesmo evento: mesmo id, mesmo data, nova assinatura com o horário atual, oripay-delivery-attempt incrementado.
Funciona para qualquer evento dos últimos 30 dias. Se a nova entrega falhar, o evento segue a agenda de reenvio automático a partir das tentativas que já fez; um evento que já esgotou as 7 tentativas volta direto a failed.
Não precisa de Idempotency-Key.
Só reenvia eventos delivered ou failed. Um evento ainda pending já está na fila e responde 409 event_pending.
Limite: 10 por minuto por conta, somando reenvios e eventos de teste. Passou disso: 429 rate_limited.
Reenviar só reentrega a notificação. O dinheiro não se move de novo.

Ficou fora do ar? Liste delivery_status=failed do período e reenvie cada um, ou faça GET dos recursos direto.

Começando

Fundamentos

Fluxos PIX

Webhooks

Testar, listar e reenviar

1. Dispare um evento de teste

2. Liste os eventos

3. Veja cada tentativa de entrega

4. Reenvie

​1. Dispare um evento de teste

​2. Liste os eventos

​3. Veja cada tentativa de entrega

​4. Reenvie

1. Dispare um evento de teste

2. Liste os eventos

3. Veja cada tentativa de entrega

4. Reenvie