O que é PIX Bacen?
A API PIX Bacen é uma versão da API Fire Banking que segue a especificação oficial do Banco Central do Brasil para o sistema de pagamentos instantâneos PIX. Esta versão foi desenvolvida para atender integradores que precisam de compatibilidade com o formato padrão BACEN.Esta API é uma alternativa à API padrão Fire Banking. Ambas oferecem as mesmas funcionalidades, mas com formatos de requisição e resposta diferentes.
Quando usar a API PIX Bacen?
Use esta API quando:- Seu sistema já está integrado com outros PSPs que seguem a especificação BACEN
- Você precisa manter compatibilidade com múltiplos provedores PIX
- Sua aplicação foi construída seguindo a documentação oficial do Banco Central
- Você prefere trabalhar com o formato de webhook V2 (envelope
{type, data})
Principais diferenças
Formato de Valores
Valores monetários são strings com 2 casas decimais (ex:
"123.45") ao invés de números.Estrutura de Webhook
Webhooks usam formato envelope
{type, data} com status LIQUIDATED ao invés de CONFIRMED.Identificadores
Usa
txid para cobranças e e2eid para devoluções, seguindo nomenclatura BACEN.Campos Separados
Contraparte dividida em
debtorAccount (pagador) e creditorAccount (recebedor).Endpoints disponíveis
Comparação com API padrão
Fluxo de integração
Próximos passos
Autenticação
Configure a autenticação para acessar a API
Ativação
Saiba como ativar o modo PIX Bacen na sua conta
Criar Cobrança
Gere sua primeira cobrança PIX
Webhooks V2
Entenda o formato de notificações V2