Guia para desenvolvedores

Como integrar uma API Pix, passo a passo

Uma integração de Pix boa tem cinco peças: autenticar, criar cobrança, receber o aviso, tratar repetição e testar. Veja a ordem que evita retrabalho.

Abrir conta Falar com o time

A ordem recomendada

1. Autentique
Gere o token com as suas credenciais e renove antes de expirar.
2. Crie a cobrança
Use um txid único por pedido, com valor e validade.
3. Mostre o QR Code
Exiba o QR e o copia e cola, e acompanhe o status da tela.
4. Receba o webhook
Valide a assinatura e libere o pedido.
5. Trate repetição
Guarde o id do evento e ignore avisos repetidos.
6. Teste no sandbox
Simule pagamento e falha antes de ir à produção.

Erros comuns

Consultar o status em loop em vez de usar webhook, não tratar o aviso duplicado, liberar o pedido antes da confirmação e não guardar o identificador da cobrança. Para entender o desenho, leia sobre idempotência e sobre o sandbox.

Perguntas frequentes

Quanto tempo leva integrar?

Depende do seu sistema. O fluxo básico de cobrança e webhook costuma ser rápido de montar e validar no sandbox.

Preciso de biblioteca específica?

Não. A API é HTTP com JSON, e funciona com qualquer linguagem.

Onde vejo exemplos?

Na documentação pública, com requisições e respostas de exemplo.