Receber Pix via API significa que o dinheiro entra e o sistema reage sozinho: libera o acesso, atualiza o pedido e registra a venda. O caminho é sempre o mesmo, independentemente da linguagem.
1. Gere a credencial no ambiente de testes
Comece pela chave de teste. Ela permite executar o fluxo inteiro sem mover dinheiro real. Guarde a chave em variável de ambiente no servidor.
2. Crie a cobrança
Envie valor, descrição e os dados de contato do cliente. A resposta traz o identificador da cobrança, o Copia e Cola e o QR Code. Guarde o identificador junto ao pedido — é ele que amarra o pagamento ao que foi vendido.
3. Exiba QR Code e Copia e Cola
Mostre os dois formatos, com contador de expiração e botão de copiar. No celular, o Copia e Cola é o caminho principal.
4. Receba o webhook
Cadastre a URL HTTPS que vai receber os eventos. Ao chegar o evento de pagamento aprovado, valide a assinatura, responda 2xx e processe em segundo plano.
5. Concilie e monitore
Registre cada evento recebido, ignore duplicados e mantenha uma rotina que consulte cobranças pendentes antigas — é a rede de segurança para o caso raro de um evento se perder.
Perguntas frequentes
- Preciso de servidor próprio para receber Pix via API?
- Você precisa de um endpoint HTTPS acessível para o webhook. Pode ser um servidor, uma função serverless ou um serviço gerenciado.
- Dá para receber Pix sem webhook?
- Dá, consultando a cobrança periodicamente, mas o resultado é mais lento e mais caro em requisições.