Callbacks
Receba no seu backend um aviso assinado quando a proposta da empresa ou da pessoa é enviada, recebe pedido de dados, é decidida ou encerrada.
Confira o HMAC de cada entrega antes de processar.
2. Eventos do callbackLeia o envelope comum a todos os eventos.
| Evento | Quando dispara |
|---|---|
proposal.submitted | A proposta foi enviada para análise ou reenviada depois de um pedido de dados. |
proposal.waiting_data | A PayZu pediu dados ao cliente. |
proposal.decided | A proposta foi aprovada ou reprovada. |
proposal.closed | A 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
callbackUrlprópria, assinada com o mesmo segredo. - Sem URL: nenhum callback é gravado.
Responda e trate repetições
| Regra | Como funciona |
|---|---|
| Resposta | 2xx em até 10 segundos. Outro status, redirecionamento, que nunca é seguido, ou demora maior contam como falha. |
| Repetição | A entrega que falhou é repetida 1, 5, 30, 120 e 480 minutos depois, num total de seis tentativas. |
| Assinatura | Uma 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.