PayZu Payments

Webhooks


Receba um POST assinado na postbackUrl da cobrança sempre que ela mudar depois da criação.

EventoQuando chega
charge.updateO pagamento mudou depois da criação: status, estorno, antifraude ou chargeback no cartão; pagamento, cancelamento, devolução ou falha no Pix.
chargebackChargeback recebido, acatado, contestado ou encerrado por prazo.
recurrence.cycleNovo 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

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.