Reenviar entregas
Mande de novo, na hora, a entrega que você precisar: a que falhou, a que já foi entregue ou a que ainda espera uma nova tentativa.
Reenvie uma entrega
curl -X POST https://api.sandbox.payzu.dev/v1/webhook-deliveries/whd_Aduv7DfwwLFCdrFLtEmNrd/retry \
-H "Authorization: Bearer SUA_CHAVE_DE_API"A resposta já traz o resultado do envio, no formato da consulta da entrega. Quando o seu endpoint aceita o reenvio, a entrega volta assim:
{
"id": "whd_Aduv7DfwwLFCdrFLtEmNrd",
"status": "delivered",
"delivered_at": "2026-11-11T15:21:04.427Z",
"attempts": {
"count": 2,
"last_at": "2026-11-11T15:21:04.427Z",
"next_at": null,
"last_status_code": 200,
"last_error": null
}
}Referência: Reenviar uma entrega
- Corpo: o mesmo da entrega, com o mesmo
iddo evento. - Destino: o endereço atual do webhook, em
webhook.url, mesmo com o webhookinactive. - Assinatura: nova, feita com o segredo atual.
- Tempo: a resposta pode levar até 5 segundos, o tempo de espera pelo seu endpoint.
- Idempotência:
Idempotency-Keyé opcional, como em Idempotência.
O reenvio repete o corpo guardado na entrega.
O recurso vai como estava no momento do evento, não no estado atual dele. Para o estado atual, consulte o recurso na API.
O que muda em cada status
| Status da entrega | O que o reenvio faz |
|---|---|
failed | Uma tentativa só. A entrega fica delivered, ou failed de novo, sem reabrir as novas tentativas automáticas. |
delivered | Uma tentativa só. Se o seu endpoint não responder 2xx, a entrega passa a failed, com delivered_at nulo: o status é o da última tentativa. |
pending | A próxima tentativa automática é feita na hora e conta como uma das 6. Se falhar, as novas tentativas automáticas seguem de onde estavam. |
A entrega pending que está sendo enviada naquele instante, ou cuja próxima tentativa sai em até cerca de 1 minuto, volta como está, sem outro envio.
Um reenvio pode repetir um evento que sua aplicação já processou.
Descarte a repetição pelo id do evento, como em Webhooks.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
| - | 404 | Entrega não encontrada para o id informado. |
Os erros de autenticação e de idempotência estão no Catálogo de erros.