API Pix: o que dá para fazer e como usar com agentes de IA
A API Pix é a especificação definida pelo Banco Central para que bancos e instituições de pagamento ofereçam cobranças e consultas Pix de forma programática. É usada por empresas que querem gerar cobranças com QR Code e conciliar recebimentos automaticamente. O acesso é sempre pelo banco ou PSP da empresa, com credenciais e certificado da conta.
Os grandes recursos da API, em português claro.
Criação de cobranças com valor e identificador, que geram QR Code e código copia e cola.
Cobranças com data de vencimento, juros, multa e desconto, no estilo de boleto.
Listagem e consulta dos Pix que entraram na conta, com identificador da transação.
Solicitação de devolução total ou parcial de um Pix recebido.
Notificação ao sistema da empresa quando um Pix é recebido na chave cadastrada.
Gestão dos endereços usados para QR Codes dinâmicos.
Como se acessa a API do Pix.
- Com credencial da sua empresaCada banco ou PSP define o acesso, mas o padrão é OAuth 2.0 com client credentials e certificado digital (mTLS) emitido para a conta da empresa.
- Documentação oficialbacen.github.io/pix-api
- Certificado e credenciais dão acesso à conta: restrinja quem pode gerenciá-los e renove antes do vencimento.
- Cada banco tem limites de requisição e particularidades além do padrão do Banco Central.
- Movimentações de saída devem sempre ter aprovação humana e teto de valor.
- api pix
- api pix banco central
- api pix cobrança
- integração api pix
- webhook pix
- api pix qr code dinâmico
- api pix documentação
O que um agente do iTeam faz com a API do Pix.
O agente gera a cobrança Pix, envia o copia e cola ao cliente e, quando o webhook confirma o pagamento, dá baixa no ERP e agradece.
O agente cruza os Pix recebidos com os títulos em aberto e lista os pagamentos sem identificação para o financeiro.
Pedidos de estorno chegam ao agente, que confere o pagamento e prepara a devolução; a execução só acontece após aprovação de um responsável.
Para títulos atrasados, o agente gera Pix com vencimento já com juros e multa da política e acompanha até o pagamento.
Da credencial ao agente trabalhando, com aprovação.
Habilite a API no seu banco
Solicite ao banco ou PSP o acesso à API Pix, gere client ID, secret e o certificado da aplicação e cadastre a chave Pix que receberá.
Guarde credenciais e certificado no cofre
O iTeam armazena credenciais e certificado no cofre; leitura e geração de cobrança podem ser automáticas, enquanto devoluções exigem aprovação.
Teste em homologação
Use o ambiente de homologação do banco, quando disponível, valide o webhook e só então passe para produção com teto de valor por operação.
Dúvidas sobre a API do Pix.
A API Pix é gratuita?
Depende do banco ou PSP. A especificação é pública, mas tarifas por cobrança ou recebimento e eventual custo de acesso são definidos no contrato com a instituição.
Preciso programar para usar a API Pix com o iTeam?
Não necessariamente. O iTeam lê a documentação da API Pix do seu banco e o time de implantação configura as rotinas; sua equipe cuida da liberação junto ao banco.
Funciona com qualquer banco?
Funciona com instituições que oferecem a API Pix para empresas. As diferenças entre bancos são tratadas na configuração.