Todos os exemplos usam a API Pix da xFlow como está documentada: base https://app.xflowpayments.com/api/v1, autenticação HTTP Basic com a chave pública e o segredo e valores em centavos. Baixe tudo de uma vez em api-pix.zip ou abra arquivo por arquivo abaixo.
Importante: o segredo (
sk_live_...) fica numa variável de ambiente do servidor. Comece pelas chaves de teste e pelo sandbox da API Pix.
Node.js
Passo a passo explicado em API Pix em Node.js.
| O que faz | Arquivo |
|---|---|
| Um cliente http pequeno | 01-um-cliente-http-pequeno.js |
| Criar a cobranca pix | 02-criar-a-cobranca-pix.js |
| Mostrar o qr code e o copia e cola | 03-mostrar-o-qr-code-e-o-copia-e-cola.js |
| Receber o webhook com express | 04-receber-o-webhook-com-express.js |
| A mesma rota com http nativo | 05-a-mesma-rota-com-http-nativo.js |
| Testar no sandbox | 06-testar-no-sandbox.js |
PHP
Passo a passo explicado em API Pix em PHP.
| O que faz | Arquivo |
|---|---|
| Uma funcao para chamar a api | 01-uma-funcao-para-chamar-a-api.php |
| Criar a cobranca pix | 02-criar-a-cobranca-pix.php |
| Exibir o qr code e o copia e cola | 03-exibir-o-qr-code-e-o-copia-e-cola.php |
| Receber o webhook | 04-receber-o-webhook.php |
| Testar no sandbox | 05-testar-no-sandbox.php |
| Conciliar as cobrancas pagas | 06-conciliar-as-cobrancas-pagas.php |
Python
Passo a passo explicado em API Pix em Python.
| O que faz | Arquivo |
|---|---|
| Um cliente para a api | 01-um-cliente-para-a-api.py |
| Sem dependencias com urllib | 02-sem-dependencias-com-urllib.py |
| Criar a cobranca pix | 03-criar-a-cobranca-pix.py |
| Mostrar o qr code e o copia e cola | 04-mostrar-o-qr-code-e-o-copia-e-cola.html |
| Receber o webhook com flask | 05-receber-o-webhook-com-flask.py |
| Testar no sandbox | 06-testar-no-sandbox.py |
| Conciliar as cobrancas pagas | 07-conciliar-as-cobrancas-pagas.py |
| Limite de requisicoes e retentativa | 08-limite-de-requisicoes-e-retentativa.py |
Licença
MIT. Use, copie e adapte livremente. Dúvidas sobre a integração: documentação e central do desenvolvedor.
Perguntas frequentes
Posso usar os exemplos no meu projeto?
Sim. Os exemplos são publicados sob a licença MIT: copie, adapte e use no seu sistema, inclusive comercial.
Os exemplos funcionam no ambiente de teste?
Sim. Use chaves de teste (pk_test_ e sk_test_) e simule o pagamento com o endpoint de teste da API; nenhum dinheiro real é movimentado.
Onde coloco o segredo da API?
Numa variável de ambiente do servidor. Nunca no código-fonte, no navegador ou num repositório.