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.
O que um agente de IA faz com a API Pix de um banco ou PSP?
A API Pix padronizada pelo Banco Central permite criar cobranças com QR Code, consultar Pix recebidos, tratar devoluções e receber avisos de pagamento. O agente gera a cobrança para um pedido, confere o recebimento pelo webhook e dá baixa no ERP. Sai da cobrança só o que estiver dentro de regra. O iTeam liga isso ao financeiro e ao WhatsApp.
Qual a diferença entre cobrança imediata e cobrança com vencimento na API Pix?
A cobrança imediata é para pagar na hora, como em um checkout, e a cobrança com vencimento carrega data limite e pode incluir multa, juros e desconto, como um boleto em Pix. A escolha depende do caso: venda no balcão ou online usa a imediata; mensalidade e fatura usam a de vencimento. O agente precisa saber qual usar em cada fluxo.
Como é a autenticação da API Pix com certificado e mTLS?
O padrão é OAuth 2.0 com client credentials, mais um certificado digital emitido para a conta da empresa, usado em conexão mTLS. O banco ou PSP define os detalhes e os escopos. O certificado dá acesso à conta, então fica em cofre, com renovação antes do vencimento. Um certificado expirado derruba a integração, o que o agente deve sinalizar.
Posso testar a API Pix sem movimentar dinheiro real?
Em geral sim, porque bancos e PSPs oferecem ambiente de homologação ou sandbox, mas cada um define o seu e a disponibilidade varia. Nele você cria cobranças e simula pagamentos. Confira na documentação do seu banco como obter as credenciais de teste e o que o sandbox simula, e valide a conciliação antes de ligar o agente em produção.
Como o agente sabe que um Pix foi pago?
Pelo webhook: você registra um endereço HTTPS para a chave Pix e o banco avisa o recebimento. O agente confirma o valor e o identificador da cobrança e dá baixa. Como o aviso pode falhar, é prudente consultar os Pix recebidos periodicamente para pegar o que escapou. O webhook também exige o mTLS configurado do lado do banco.
A API Pix é igual em todos os bancos?
A especificação do Banco Central é a mesma, mas cada banco tem particularidades de acesso, limites de requisição, escopos e prazos de homologação. Trocar de banco exige revisar credenciais e testar de novo. Por isso, o agente deve isolar a conexão em um conector por banco. Confira a documentação do seu PSP para limites e cadastro da chave.
O agente pode fazer devolução de Pix sozinho?
A API permite devoluções, mas é uma saída de dinheiro, então fica sob aprovação humana e teto de valor. O agente pode abrir a solicitação com motivo e dados do pagamento, e uma pessoa do financeiro confirma. Devolver sem checar pode causar fraude e duplicidade. Registre quem aprovou e o identificador da devolução para a conciliação.
A API Pix tem custo para a empresa?
O custo vem do banco ou PSP, que define tarifas por cobrança, por recebimento ou por pacote, e varia entre instituições. A especificação em si é aberta. Confira com o seu banco a tabela e eventuais condições para uso da API. Compare também o tempo que a conciliação automática economiza, junto ao custo do modelo de IA do agente.
