PayZu Payments
Webhooks
Receba um POST assinado na postbackUrl da cobrança sempre que ela mudar depois da criação.
| Evento | Quando chega |
|---|---|
charge.update | O pagamento mudou depois da criação: status, estorno, antifraude ou chargeback no cartão; pagamento, cancelamento, devolução ou falha no Pix. |
chargeback | Chargeback recebido, acatado, contestado ou encerrado por prazo. |
recurrence.cycle | Novo ciclo de recorrência, aprovado ou negado. |
Os headers e o corpo de cada evento estão na página dele. O resumo dos valores de event está em Eventos do webhook.
Como integrar
1. Validação da assinatura
Confira a assinatura de cada aviso e responda 2xx em até 5 segundos.
Leia o evento em event e a cobrança em data.
A URL vai em cada POST /charges.
Não existe cadastro de URL por conta.
Quando o aviso não é enviado
- Na criação da cobrança, inclusive a que abre uma recorrência, porque o resultado da autorização já vem na resposta do
POST /charges. - No pedido de estorno ou de devolução: o aviso vem no resultado, inclusive na devolução do Pix não concluída.
- Na mudança de status, na desativação, na reativação e na troca de valor de uma recorrência.
- Quando a cobrança não tem
postbackUrl. - Quando a credencial da conta não tem o segredo de assinatura configurado.