PayZu Pix

Arquitetura da integração


Nesta páginaChamadas do seu sistemaProcessamento na PayZuAvisos para o seu sistemaConsulta

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.

Arquitetura da integração: o seu sistema chama a API, a PayZu leva a operação à instituição parceira e ao Pix do Banco Central e avisa o seu sistema a cada mudança 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.