PayZu PixWebhooks e callbacks
Reenviar as falhas de um webhook
Reponha as entregas com falha que um webhook acumulou.
Reenvie as falhas de um webhook
bash
curl -X POST https://pix.sandbox.payzu.dev/v1/user/callbacks/resend/webhook/cm3w7k1t40000q8f2r5b9x3ad \
-H "Authorization: Bearer SEU_TOKEN"json
{
"enqueued": {
"count": 2,
"truncated": false,
"items": [
{ "transactionId": "PAYZU20260811K7M2X9QP4T000000", "webhookId": "cm3w7k1t40000q8f2r5b9x3ad", "eventType": "TRANSACTION_COMPLETED" },
{ "transactionId": "PAYZU20260812H9VB3KQ7XM000000", "webhookId": "cm3w7k1t40000q8f2r5b9x3ad", "eventType": "TRANSACTION_CANCELED" }
]
}
}Referência: Reenviar as entregas com falha de um webhook
| Regra | Como funciona |
|---|---|
| Alcance | A rota percorre todo o histórico do webhook, sem janela de datas. |
| O que entra | Para cada transação e evento, a rota olha a última tentativa e reenvia só se ela não recebeu 2xx. |
| Webhook pausado ou excluído | Não aceita reenvio. |
count | Soma tudo o que foi para a fila. |
items | Mostra no máximo 500 itens, com truncated: true quando há mais. |
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZW300 | 404 | Webhook não encontrado, está inativo, ou não pertence ao usuário |
PZW310 | 404 | Nenhum callback falho encontrado para o webhook |
PZG422 | 422 | Limite de reenvios atingido. Tente novamente em 1 minuto. |
Os códigos de autenticação e de validação estão no Catálogo de erros.