Arquitetura da integração
O seu sistema chama a API para criar e consultar cada operação, e a PayZu avisa o seu sistema sempre que uma delas muda de status.
Chamadas do seu sistema
Toda chamada vai por HTTPS, com o token no cabeçalho Authorization. Em produção, se a conta tem IP cadastrado, a chamada precisa sair de um deles. Veja Autenticação e IP cadastrado.
Processamento na PayZu
A PayZu leva cada cobrança e cada envio à instituição financeira parceira, que registra a operação no Pix do Banco Central. A resposta da chamada traz a transação com o status do momento, que no começo costuma ser PENDING.
Avisos para o seu sistema
Quando a operação muda de status, a PayZu envia um aviso por HTTP ao endereço que você informou em callbackUrl e aos webhooks cadastrados na conta. O seu sistema responde com 2xx e confere a assinatura de cada aviso. Veja Webhooks e callbacks e Assinatura dos callbacks.
Consulta
Para conferir uma operação, consulte a transação pelo id ou pelo clientReference em GET /pix. A consulta serve de apoio aos avisos, por exemplo para checar um pedido cujo aviso não chegou.