PayZu Conta HubWebhooks e callbacks
Reenviar entregas
Depois de corrigir o seu endpoint, recupere os avisos que ele não confirmou.
1. Listar as entregas
Ache as entregas FAILED ou ABANDONED.
Veja o corpo enviado e a resposta do seu endpoint.
Reenvie a entrega
- O que vai: o mesmo corpo e o mesmo
X-Payzu-Delivery, comX-Payzu-Timestampnovo e a assinatura feita com o segredo atual do destino. - Quando: na hora. O
responseCodee oresponseBodyda resposta são os desta tentativa. - Status aceitos: qualquer um, inclusive
ABANDONED. Uma entregaDELIVEREDcontinuaDELIVEREDmesmo que o reenvio falhe. - Webhook: precisa estar ativo, mas o evento não precisa mais estar na lista dele.
- Cota: até 20 chamadas por minuto por conta.
bash
curl --request POST \
--url 'https://api.sandbox.payzu.dev/api/v1/transactions/webhooks/deliveries/cmu1r7x2k000701s6dlvr0007/resend' \
--header 'Authorization: Bearer SEU_TOKEN'json
{
"id": "cmu1r7x2k000701s6dlvr0007",
"event": "WITHDRAW_FAILED",
"status": "DELIVERED",
"attempts": 4,
"responseCode": 200,
"deliveredAt": "2026-10-05T15:10:02.318Z",
"responseBody": ""
}Referência: Reenviar uma entrega de um webhook
A resposta traz a entrega inteira, como na consulta; o exemplo mostra só o que muda.
Se o aviso original já foi processado, descarte o reenvio pelo id e responda 2xx.
O id do envelope é o mesmo no aviso original e no reenvio.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
WEBHOOK_DELIVERY_NOT_FOUND | 404 | Entrega de webhook não encontrada. |
WEBHOOK_DELIVERY_CALLBACK_SECRET_MISSING | 422 | A conta não tem segredo de callback; gere um antes de reenviar este aviso. |
WEBHOOK_DELIVERY_DESTINATION_MISSING | 422 | Esta entrega não tem destino registrado e não pode ser reenviada. |
WEBHOOK_DELIVERY_PAYLOAD_PURGED | 422 | O conteúdo deste aviso foi expurgado por tempo e não pode ser reenviado. |
WEBHOOK_DELIVERY_WEBHOOK_INACTIVE | 422 | O endpoint da loja está desativado; ative-o antes de reenviar. |
Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.