Produtos ERPPro
Loja Virtual
Com domínio próprio e integrada ao ERP. Venda online sem pagar por pedido.
Delivery Próprio
Pedidos e rotas dentro do ERP. Sem depender de apps de entrega.
CRM + RevOps
Todo tipo de venda integrado B2B, B2C, balcão e online com follow-up automático.
Catálogo Digital
Seu mix de produtos em link único, sempre com o estoque e o preço do ERP.
Marketplaces
Ver todos os marketplaces
Pagamentos
Ver todos os pagamentos
Automação
Ver todas as automações
Moda, varejo e especializado
Lojas de Cosméticos Papelarias e Mat. Escolar Utilidades e Presentes Agropecuária
Construção e materiais
Material de Construção Ferragens
Distribuição e alimentos
Veículos e peças
Digital e omnichannel

API Pix com baixa automática: Inter, Efí, Sicoob, Sicredi e BB integrados ao ERP

Por Adriano da ERPPro · Atualizado em 20/11/2026

A API Pix é a ligação, no padrão do Banco Central, entre o sistema da loja e o banco onde está a conta. Com ela, o sistema gera um QR Code dinâmico para cada venda, e o banco confirma aquela cobrança quando o cliente paga. É isso que permite o Pix com baixa automática: a venda e a conta a receber fecham sozinhas, sem ninguém conferir comprovante.

Testar grátis por 7 dias Ver planos e preços
API Pix no ERPPro: tela Contas que recebem com Banco Inter, Efí, Sicoob, Sicredi e Banco do Brasil e o passo a passo Como conectar aberto

O que é a API Pix

O Pix é do Banco Central, mas a conta da loja está num banco. A API Pix é a porta que o banco abre para o sistema da empresa conversar com essa conta. O Banco Central publica a especificação, e os bancos seguem o mesmo padrão, descrito no Manual de Padrões para Iniciação do Pix. Por isso o desenho é parecido de banco para banco; muda o portal, o certificado e o nome de alguns campos.

Pela API Pix, o sistema da loja consegue:

  • Criar uma cobrança com valor e identificador próprios (o txid), que vira o QR Code dinâmico e o Pix copia e cola.
  • Consultar a cobrança e saber se ela está ativa ou concluída (paga).
  • Receber o aviso do banco (webhook) quando um Pix ligado à cobrança cai na conta.
  • Listar os Pix recebidos e pedir devolução de um Pix.

Na prática, a API Pix é para o lojista o mesmo que a maquininha TEF é para o cartão: o valor sai do sistema, e a resposta do banco volta para a venda, sem digitar nada duas vezes.

Pix comum × API Pix

Pix comum (chave ou QR Code impresso)API Pix (QR Code dinâmico)
ValorO cliente digita, ou o QR Code impresso já traz um valor fixoO sistema gera o valor exato de cada venda
IdentificaçãoFica difícil saber qual venda foi pagaCada cobrança tem um identificador (txid)
ConfirmaçãoAlguém confere o comprovante ou o extratoO banco confirma aquela cobrança para o sistema
Baixa no sistemaManualAutomática
Vencimento, juros e multaNão temTem, na cobrança com vencimento
O que precisaSó a chave PixIntegração com o banco: credenciais, certificado e permissões

QR Code estático, dinâmico, cobrança imediata e com vencimento

O Regulamento do Pix define dois tipos de QR Code. No estático, os dados do pagamento ficam dentro do próprio código, que serve para vários pagamentos. No dinâmico, o código aponta para uma cobrança criada pela loja na API Pix, e o aplicativo do cliente busca os dados no banco na hora de pagar. A API Pix trabalha com duas espécies de cobrança:

Cobrança imediata

Para pagar agora, no balcão ou no site. O sistema cria a cobrança, mostra o QR Code na tela do caixa e, quando o cliente paga, o banco marca a cobrança como concluída. Tem prazo de expiração: depois dele, não aceita pagamento.

Cobrança com vencimento

Para pagar depois, como uma parcela. A cobrança leva data de vencimento, multa, juros e desconto. Se o cliente paga depois do vencimento, é o banco que calcula o valor final. O QR Code pode ir no carnê, na mensagem ou no e-mail.

Exemplo fictício: parcela paga com atraso

Parcela de R$ 200,00, com multa de 2% e juros de 1% ao mês, contados por dia. Números supostos, só para a conta. O cliente paga 15 dias depois do vencimento.

  1. Multa: R$ 200,00 × 2% = R$ 4,00
  2. Juros: R$ 200,00 × 1% × 15 ÷ 30 = R$ 1,00
  3. Valor cobrado pelo banco: R$ 200,00 + R$ 4,00 + R$ 1,00 = R$ 205,00

Com a cobrança com vencimento, o cliente paga o valor certo sem a loja refazer a conta. As regras de multa e juros da sua venda a prazo devem seguir o contrato com o cliente; confirme com o seu contador como lançar os encargos.

Webhook ou consulta: como o sistema fica sabendo do pagamento

Depois que o cliente paga, o sistema precisa saber. A API Pix tem dois caminhos, e os dois chegam à confirmação:

  • Consulta: o sistema pergunta ao banco, de tempos em tempos, se aquela cobrança foi concluída. É o caminho mais simples e funciona em todos os bancos.
  • Webhook: o banco avisa o sistema assim que o Pix cai na conta. O Banco Central descreve o webhook como a inversão da lógica: em vez de perguntar o tempo todo, o recebedor passa a ser informado quando o pagamento acontece. Só os Pix ligados a uma cobrança (com txid) são avisados.

O webhook é cadastrado na chave Pix da conta e exige um endereço seguro (HTTPS) do lado do sistema. Se o cadastro falhar ou o endereço mudar, os avisos param de chegar; por isso, um bom sistema continua consultando a cobrança enquanto espera.

O que é Pix com baixa automática e por que acaba com a conferência

Baixa automática é quando a confirmação do banco fecha sozinha a venda ou a conta a receber no sistema, com o valor pago, a data e a forma de pagamento. Sem ela, o Pix cai no banco, mas a conta continua aberta até alguém conferir o extrato e dar baixa à mão. É nessa diferença que mora o trabalho e o erro.

Exemplo fictício: quanto tempo a conferência manual consome

Uma loja recebe 80 Pix por dia e abre 26 dias por mês. Suponha que conferir cada comprovante no aplicativo do banco leve 30 segundos.

80 Pix × 30 s = 2.400 s = 40 min por dia → 40 min × 26 dias = 1.040 min ≈ 17 h 20 min por mês

Com a API Pix, essas horas viram zero conferência no balcão: o banco confirma, o caixa segue. E o que não bate (valor diferente, pagamento em dobro) aparece separado para uma pessoa decidir.

A baixa automática também deixa a conciliação bancária mais curta, porque cada Pix já entra identificado, e o fluxo de caixa mostra o dinheiro no dia em que entrou.

O que pedir ao banco para usar a API Pix

Antes de ligar o sistema, a empresa precisa liberar a API Pix na própria conta. Cada banco tem o seu caminho, mas a lista do que você vai ter em mãos é quase sempre a mesma. Nunca mande esses dados por mensagem aberta: eles dão acesso à cobrança da sua conta.

ItemO que éOnde sai
Conta PJ e chave PixA conta que recebe e uma chave Pix dela (CNPJ, e-mail, telefone ou aleatória). O dinheiro cai nessa chaveNo banco
Client IDA identificação da integração (a “aplicação”) no bancoNo portal do desenvolvedor ou no internet banking
Client SecretA senha dessa integração. Alguns bancos mostram uma vez sóNa mesma tela do Client ID (o Sicoob não usa)
Chave da aplicaçãoUm código a mais que alguns bancos pedem, como a Developer Application Key do Banco do BrasilNa tela de credenciais
Certificado digitalO arquivo que prova que a chamada vem da sua empresa (autenticação mútua, mTLS)Emitido pelo banco ou o certificado A1 da empresa, conforme o banco
Permissões (escopos)O que a integração pode fazer: cobrança imediata, com vencimento, Pix recebidos, devolução, aviso (webhook)Marcadas ao criar a integração

Marque todas as permissões da API Pix. Escopo faltando é o erro mais comum: tudo parece certo, mas o banco recusa a cobrança ou o aviso. Também confirme que as credenciais são de produção, e não de teste (homologação).

API Pix no Inter, Efí, Sicoob, Sicredi e Banco do Brasil: o caminho de cada banco

Linhas gerais conferidas nas fontes oficiais de cada banco em 20/11/2026. Os menus mudam com o tempo: em dúvida, siga o portal do banco e o gerente da conta.

API Pix Inter

  1. Entre no Internet Banking da conta PJ.
  2. Abra Soluções para sua empresa › Nova integração e aceite as permissões.
  3. Na lista de integrações, baixe a chave e o certificado e copie as credenciais.

O Inter oferece cobrança imediata, cobrança com vencimento e webhook.

API Pix Efí

  1. Na conta Efí, abra API › Criar aplicação, habilite a API Pix e escolha os escopos.
  2. Copie o Client ID e o Client Secret de produção.
  3. Em Meus Certificados, gere o certificado e baixe na hora: o download é feito logo após a criação.

Cada aplicação tem um par de credenciais para produção e outro para teste.

API Pix Sicoob

  1. Confirme com a cooperativa a disponibilidade da API Pix para a sua conta PJ.
  2. No Portal de Desenvolvedores do Sicoob, cadastre o aplicativo da empresa com a API Pix (recebimentos) e todas as permissões.
  3. Copie o Client ID gerado para o aplicativo.

O Sicoob oferece as APIs a cooperados pessoa jurídica.

API Pix Sicredi

  1. Peça à cooperativa a adesão à API Pix e assine o termo de adesão.
  2. No Portal do Desenvolvedor Sicredi, o técnico registra o pedido de certificado (CSR) e baixa o certificado assinado.
  3. Sobre esse certificado, gere as credenciais de produção (Client ID e Client Secret).

A Sicredi pede chave Pix na conta e celular e e-mail atualizados no cadastro.

API Pix Banco do Brasil

  1. No Portal Developers BB, crie uma nova aplicação com a API Pix.
  2. Em Detalhes da Aplicação, pegue as credenciais e leve a aplicação do teste à produção.
  3. Tenha em mãos o Client ID, o Client Secret, a Developer Application Key e o certificado.

Faça com o responsável pela conta PJ da empresa.

No ERPPro, o passo a passo está na tela

Na lista de bancos do ERPPro, o botão Como conectar abre o caminho daquele banco e diz exatamente o que informar depois. No Sicredi, a parte técnica no portal pode ser feita pela equipe ERPPro com o ID de adesão que a cooperativa envia.

API Pix tem tarifa?

A integração em si costuma não ter mensalidade, mas o Pix recebido pela empresa pode ter tarifa, e alguns bancos cobram pelo QR Code dinâmico ou pela cobrança com vencimento. Quem define o valor é o banco, em contrato, e ele aparece no comprovante e no extrato. Antes de escolher o banco, pergunte três coisas: a tarifa do Pix recebido, a tarifa do Pix Cobrança (imediata e com vencimento) e se há teto ou pacote. As regras do Banco Central sobre quem pode ser cobrado estão explicadas na página sobre a taxa do Pix.

E a API Pix não é a mesma coisa que um intermediário: com ela, o dinheiro cai direto na conta da loja, no banco que ela escolheu. Para o cartão, o caminho passa por outros participantes; veja como funciona um gateway de pagamento.

Segurança: certificado, credenciais e LGPD

Certificado e mTLS

O Banco Central exige que a API Pix use autenticação OAuth 2.0 com TLS mútuo: o banco só aceita a chamada que traz o certificado da empresa. Certificado autoassinado não vale. Guarde o arquivo e a senha como guarda o certificado da nota fiscal, e anote a validade.

Credenciais

Client ID, Client Secret e chave da aplicação dão acesso à cobrança da conta. Entregue só ao sistema, nunca por e-mail ou mensagem aberta. Se vazar, gere outras no banco: a anterior deixa de valer.

LGPD

O Pix recebido traz nome e CPF ou CNPJ de quem pagou. Para pessoa física, são dados pessoais protegidos pela LGPD. Use só para a venda e a cobrança, limite quem vê e não exporte para planilhas soltas.

Comprovante falso

Na API Pix, quem confirma é o banco, não a tela do celular do cliente. O print editado deixa de ser problema no balcão.

Erros comuns na integração da API Pix

ErroO que aconteceComo resolver
Certificado vencidoO banco recusa a conexão; o caixa não gera nem confirma PixGere o novo certificado no banco antes do vencimento e troque no sistema
Escopo (permissão) faltandoA cobrança ou o aviso é recusado, mesmo com credencial certaEdite a integração no banco e marque todas as permissões da API Pix
Credencial de teste em produçãoNada funciona na conta realUse o Client ID e o Client Secret de produção
Client Secret gerado de novoA integração para: o segredo antigo deixou de valerInforme o segredo novo no sistema
Chave Pix de outra contaA cobrança é recusada ou o Pix não é reconhecidoUse uma chave da mesma conta da integração
Webhook não cadastrado ou fora do arO aviso não chega e a venda fica esperandoConfira o cadastro do webhook na chave Pix e mantenha a consulta como reserva
Certificado perdidoNão dá para reconectarGuarde o arquivo: em alguns bancos o download é feito uma vez só
Valor pago diferenteA baixa automática não deve fechar a contaUma pessoa confere e dá a baixa com o valor certo

As dores do Pix sem integração e como resolver

Fila no caixa

O cliente paga e espera alguém abrir o banco para conferir. Com o QR Code dinâmico, o banco confirma e o caixa segue.

Print falso

Comprovante editado passa no movimento. A confirmação vem do banco, não do celular do cliente.

Pix lançado como dinheiro

O fechamento não bate. No sistema de caixa para loja, o Pix confirmado entra como PIX.

Conta paga e ainda aberta

O cliente pagou a parcela e recebeu cobrança de novo. Com a baixa automática, a conta fecha quando o banco confirma.

Lembrete sem link

A mensagem cobra, mas o cliente não tem como pagar ali. Mande o link do Pix junto na mensagem de lembrete de pagamento.

Inadimplência escondida

Sem baixa no dia, a lista de atrasados mente. Com o Pix baixando sozinho, a inadimplência aparece de verdade.

Onde o ERPPro entra: API Pix integrada à conta da loja

No ERPPro, a API Pix está integrada ao Banco Inter, Efí, Sicoob, Sicredi e Banco do Brasil. A conexão é feita com a conta da própria loja: o dinheiro cai direto nela, e as credenciais ficam guardadas criptografadas. No Inter e na Efí, o ERPPro cadastra o aviso automático do banco (webhook); nos outros, consulta a cobrança no banco. A lista completa de bancos, maquininhas e plataformas está em integrações do ERPPro.

Com a conta ligada, o Pix aparece em três lugares: no Caixa Ágil, com o QR Code dinâmico da venda; no contas a receber, com o botão Cobrar; e na régua de cobrança do WhatsApp, com o link de pagamento na mensagem. Nos três, a confirmação do banco faz a baixa.

Caixa Ágil com dados fictícios (Empório Vila Serena). O QR Code do vídeo é fictício e não paga nada.

Como ligar a API Pix ao ERPPro, passo a passo

Telas reais do ERPPro, com dados fictícios de demonstração.

  1. Escolha o banco e abra o Como conectar

    Em ERPPro Pay › Configurar, na lista Contas que recebem, ache o seu banco e clique em Como conectar. A tela mostra o caminho no banco e o que trazer.

  2. Pegue as credenciais no banco

    Crie a integração com a API Pix, marque todas as permissões e baixe ou envie o certificado, como no quadro do seu banco acima.

  3. Conecte a conta no ERPPro

    Clique em Conectar e informe as credenciais, a chave Pix que recebe e o certificado. Depois de gravados, os dados nunca aparecem por inteiro na tela.

API Pix Banco do Brasil no ERPPro: formulário Conectar Banco do Brasil (Pix) com Client ID, Client Secret, Application Key, chave Pix e certificado, dados fictícios e mascarados
Conectar o Banco do Brasil (Pix): credenciais, chave Pix e certificado, com dados fictícios.
  1. Cobre no Caixa Ágil

    Lance a venda e toque em Outros › Receber por link. Com mais de um banco conectado, o caixa pergunta por qual receber. O QR Code dinâmico aparece na tela, ou vai por link no WhatsApp.

  2. Deixe o banco confirmar

    Quando o banco confirma, o PIX entra na venda sozinho, com o valor pago. Finalize, com NFC-e se a loja emite (veja o emissor de NFC-e).

API Pix no Caixa Ágil do ERPPro: janela Receber por link com o QR Code dinâmico do Pix da venda de R$ 43,20, produtos de padaria, dados fictícios
QR Code dinâmico da venda no Caixa Ágil. O código da foto é fictício.
  1. Cobre as contas a receber pelo mesmo Pix

    Em Contas a receber, abra a conta em aberto e use Cobrar › Pix ou link de pagamento. Pagou e o banco confirmou, a conta baixa sozinha, com a forma PIX e a data do pagamento. Valor diferente fica para uma pessoa conferir.

  2. Ligue o link na régua do WhatsApp

    Em WhatsApp › Notificações, ligue Mandar o link de pagamento nas cobranças. O lembrete leva o link, e o Pix pago baixa a conta. Veja também a cobrança automática.

Pix com baixa automática no ERPPro: lista de contas a receber com cliente, valor recebido, data de recebimento, estado Recebido e tipo Pagamento Instantâneo (PIX), dados fictícios
Contas a receber filtradas por Pix: valor, data de recebimento, estado e forma de pagamento.

No crediário, o carnê pode sair com um Pix com vencimento por parcela no Inter da loja, com a multa e os juros configurados no ERPPro. Pago depois do vencimento, o que passou do valor da parcela entra como multa e juros na baixa. Veja como montar o carnê de pagamento.

Checklist da API Pix na loja

  • Conta PJ com chave Pix ativa
  • Tarifa do Pix recebido e do Pix Cobrança no contrato
  • Integração criada no portal do banco
  • Todas as permissões da API Pix marcadas
  • Credenciais de produção, não de teste
  • Certificado guardado e validade anotada
  • Chave Pix da mesma conta da integração
  • Sistema que gera QR Code dinâmico no caixa
  • Confirmação pelo banco, sem print
  • Baixa automática no contas a receber
  • Link do Pix na mensagem de cobrança
  • Quem pode ver os dados de pagamento definido

Glossário rápido da API Pix

API Pix
Interface padronizada pelo Banco Central para o sistema da empresa criar e acompanhar cobranças Pix no banco.
QR Code dinâmico
Código que aponta para uma cobrança criada pela loja, com valor e identificador próprios.
Cobrança imediata (cob)
Cobrança para pagar na hora, com prazo de expiração.
Cobrança com vencimento (cobv)
Cobrança com data de vencimento, multa, juros e desconto.
txid
O identificador de cada cobrança, que liga o Pix pago à venda.
Webhook
Aviso que o banco manda ao sistema quando o Pix de uma cobrança cai na conta.
Escopo
Cada permissão da integração, como criar cobrança ou ler os Pix recebidos.
mTLS
Autenticação mútua: o banco só aceita a chamada que traz o certificado da empresa.
Client ID e Client Secret
A identificação e a senha da integração no banco.
Baixa automática
A conta ou a venda fecha sozinha no sistema quando o banco confirma o pagamento.

Perguntas frequentes sobre a API Pix

O que é API Pix?

É a interface padronizada pelo Banco Central que liga o sistema da empresa ao banco onde está a conta. Com ela, o sistema cria a cobrança Pix com QR Code dinâmico, consulta se foi paga, recebe o aviso do banco (webhook) e pede devolução, sem ninguém abrir o aplicativo do banco.

Qual a diferença entre o Pix comum e a API Pix?

No Pix comum, o cliente paga por chave ou QR Code estático e a loja confere o comprovante ou o extrato. Na API Pix, o sistema gera um QR Code dinâmico para cada venda, com valor e identificador próprios, e o banco devolve a confirmação daquela cobrança. Por isso a baixa pode ser automática.

Preciso de API Pix para receber Pix na loja?

Não. Dá para receber por chave ou QR Code impresso. A API Pix vale a pena quando a conferência manual toma tempo, quando há comprovante falso no balcão ou quando a loja tem contas a receber e quer a baixa automática.

Quais bancos têm API Pix?

A API Pix segue a especificação do Banco Central, e cada banco ou instituição decide se oferece e como libera o acesso. No ERPPro, a API Pix está integrada ao Inter, Efí, Sicoob, Sicredi e Banco do Brasil, com o dinheiro caindo na conta da própria loja.

O que é webhook do Pix?

É o aviso que o banco manda para o sistema da empresa quando um Pix ligado a uma cobrança cai na conta. Sem webhook, o sistema precisa perguntar ao banco de tempos em tempos se a cobrança foi paga. Os dois caminhos levam à confirmação; o webhook avisa na hora.

O que é Pix com baixa automática?

É quando o pagamento confirmado pelo banco fecha sozinho a venda ou a conta a receber no sistema, com valor, data e forma de pagamento. Ninguém precisa conferir o extrato e dar baixa à mão, e o caixa fecha com o Pix no lugar certo.

Quanto custa usar a API Pix?

O custo é a tarifa que o banco cobra da empresa pelo Pix recebido e, em alguns bancos, pelo QR Code dinâmico ou pela cobrança com vencimento. O valor é definido pelo banco em contrato e aparece no comprovante e no extrato. Veja como funciona na página sobre a taxa do Pix.

MEI pode usar API Pix?

Os bancos oferecem a API Pix para conta de empresa. O MEI tem CNPJ e pode abrir conta PJ; confirme com o seu banco se a API Pix está liberada para a sua conta e qual é a tarifa.

Que certificado a API Pix pede?

Toda chamada à API Pix usa autenticação mútua (mTLS), com um certificado digital. Alguns bancos emitem o próprio certificado no portal, como Inter, Efí e Sicredi. No ERPPro, Sicoob e Banco do Brasil usam o certificado A1 da empresa (o mesmo tipo da nota fiscal), com a parte pública cadastrada no portal do banco.

Quais permissões (escopos) marcar na API Pix?

Marque todas as permissões da API Pix: cobrança imediata, cobrança com vencimento, consulta de Pix recebidos e devolução, e aviso de pagamento (webhook). Escopo faltando é um dos erros mais comuns: a cobrança é recusada mesmo com Client ID e certificado certos.

O que acontece quando o certificado vence?

O banco recusa a conexão e o sistema para de gerar e de confirmar cobranças Pix. Anote a validade, gere o novo certificado no banco antes do vencimento e troque no sistema no mesmo dia.

Pix Cobrança com vencimento substitui o boleto?

Pode substituir em muitas vendas a prazo: tem vencimento, multa, juros e desconto, e o dinheiro cai na hora. A partir de 1º de fevereiro de 2027, a cobrança híbrida junta boleto e Pix Cobrança com vencimento no mesmo documento, e o cliente escolhe como pagar.

Fonte oficial: Manual de Padrões para Iniciação do Pix (Banco Central), com a especificação da API Pix, os tipos de cobrança, o webhook e os requisitos de segurança.

Leia também

Pix confirmado pelo banco, venda e conta fechadas sozinhas

A ERPPro está no varejo desde 1996 e atende mais de 8.000 clientes ativos. Teste o Caixa Ágil com API Pix, contas a receber e cobrança pelo WhatsApp por 7 dias.

Testar grátis por 7 dias Ver planos e preços

Conteúdo informativo, conferido no Manual de Padrões para Iniciação do Pix do Banco Central e nas páginas oficiais dos bancos em 20/11/2026. Tarifas são definidas por cada banco em contrato. Para dúvidas sobre impostos e encargos, confirme com o seu contador.

Rolar para cima