PayZu PixWebhooks e callbacks
Reenviar callbacks
Peça de novo os avisos que o seu endpoint perdeu, sem esperar as retentativas automáticas, pela rota do canal e do volume afetado.
Escolha a rota
Antes de reenviar, veja o que falhou no Histórico de callbacks.
| Situação | Como reenviar |
|---|---|
O aviso de uma transação com callbackUrl não foi processado | Reenviar o callback de uma transação |
O endpoint do callbackUrl ficou fora do ar por um período | Reenviar os callbacks de um período |
| Um webhook acumulou entregas com falha | Reenviar as falhas de um webhook |
| Vários webhooks falharam no mesmo período | Reenviar as falhas dos webhooks por período |
As quatro rotas de reenvio dividem uma cota de 5 chamadas por conta.
A sexta responde 422, e a cota só volta 1 minuto depois da última chamada aceita.
Depois do reenvio
| O que saber | Detalhe |
|---|---|
| Estado do aviso | O aviso leva o estado atual da transação, não o do momento da falha. |
| Retentativas | Cada aviso reenviado segue as retentativas normais. Confira a entrega no Histórico de callbacks, filtrando por transactionId ou webhookId. |
| Evento descartado | Nos webhooks, um evento cujo status já não é o da transação é descartado no envio, sem registro no histórico, menos o TRANSACTION_REFUNDED da devolução parcial. Por isso count conta o que entrou na fila, não o que será entregue. Para conferir o estado atual, consulte GET /pix. |
| Infração | O reenvio de INFRACTION_CHANGED pode vir sem infraction: consulte a infração em GET /user/infractions, com o id da transação no filtro transactionId. |
Um reenvio pode repetir avisos que a sua aplicação já processou.
Deduplique como em Webhooks e callbacks: id + updatedAt nos avisos de transação e só infraction.id + infraction.updatedAt nos de infração.