PayZu OnboardingIntegração

Callbacks


Receba no seu backend um aviso assinado quando a proposta da empresa ou da pessoa é enviada, recebe pedido de dados, é decidida ou encerrada.

EventoQuando dispara
proposal.submittedA proposta foi enviada para análise ou reenviada depois de um pedido de dados.
proposal.waiting_dataA PayZu pediu dados ao cliente.
proposal.decidedA proposta foi aprovada ou reprovada.
proposal.closedA proposta terminou sem decisão: foi cancelada, inclusive em análise, ou o prazo venceu.

Os headers e o corpo de cada evento estão na página dele.

A proposta do sócio não gera callback.

Os eventos saem para a proposta da empresa ou da pessoa. O pedido de dados a um sócio e a revogação de uma aprovação também não geram callback. A revogação também não muda o APPROVED da proposta, então a consulta não a revela.

O destino

A PayZu cadastra no seu tenant a URL que recebe os callbacks e o segredo que assina as entregas. Combine os dois com ela para o sandbox e para a produção.

  • URL: https, pública, sem credenciais e sem fragmento.
  • Por proposta: a criação aceita uma callbackUrl própria, assinada com o mesmo segredo.
  • Sem URL: nenhum callback é gravado.

Responda e trate repetições

RegraComo funciona
Resposta2xx em até 10 segundos. Outro status, redirecionamento, que nunca é seguido, ou demora maior contam como falha.
RepetiçãoA entrega que falhou é repetida 1, 5, 30, 120 e 480 minutos depois, num total de seis tentativas.
AssinaturaUma entrega nunca sai sem assinatura.

O mesmo evento pode chegar mais de uma vez.

Grave o id, que é o mesmo em todas as tentativas de uma entrega, e ignore o que já processou. Para decidir, leia o status em Consultar uma proposta.