Checklist Integração PIX - Banco do Brasil

✓ Checklist salvo automaticamente!

Respondidas

Pendentes

Progresso

1 Certificado Digital A1

Requisitos técnicos e procedimentos de emissão

Qual é o processo para emitir certificado A1 pela instituição? Vocês emitem ou preciso contratar de terceiro?

Qual é o prazo de emissão do A1?

Quais são os requisitos técnicos? Preciso de leitora de cartão ou token?

Esse A1 será válido para APIs e integração técnica ou apenas para operações administrativas?

Qual é o custo anual do certificado A1?

É possível renovar o A1 automaticamente ou preciso repetir todo o processo?

2 PIX - Recebimento (Modelo e Operacional)

Configurações de recebimento e limites operacionais

Qual é o modelo de recebimento de PIX que vocês oferecem para PJ? (Conta corrente, MP — Módulo PIX, ou integração por API?)

É possível receber PIX dinâmicos (QR code com valor variável) pela nossa plataforma?

Vocês oferecem PIX por chave (CPF, CNPJ, email, telefone) ou apenas por conta?

Qual é a taxa/tarifa por transação PIX recebida?

Há limite mínimo ou máximo por transação ou por dia?

Qual é o tempo de liquidação? (T+0, T+1 ou outro?)

Vocês oferecem PIX por QR code estático (para exibir na plataforma permanentemente)?

É possível gerar PIX com descrição personalizada ou identificador de transação (reference_id)?

3 Integração Técnica (API PIX)

Especificações de API, autenticação e comunicação

Vocês disponibilizam API REST ou SOAP para integração PIX?

Qual é a documentação técnica disponível? Posso ter acesso antes de contratar?

Como funciona a autenticação? Preciso usar certificado digital, OAuth, API Key, ou outro método?

Vocês suportam mTLS (mutual TLS) para autenticação de API? Se sim, qual é o certificado aceito?

Qual é o endpoint base da API? Existe um ambiente de homologação separado?

Qual é o formato de resposta? (JSON, XML, outro?)

Vocês fornecem SDK/Biblioteca pronta para integração (Node.js, Python, Java, etc.)?

Qual é o versionamento da API? Como vocês lidam com breaking changes?

4 Webhooks e Notificações em Tempo Real

Comunicação de eventos e confirmações de transações

Como vocês notificam quando um PIX é recebido? (Polling, Webhook, ou outra forma?)

Se for webhook: qual é o formato das notificações? Vocês enviam para uma URL nossa?

Qual é a latência típica? Quanto tempo depois do PIX chegar eu recebo a notificação?

Há retry automático se meu servidor não responder ao webhook? Qual é a política de retentativa?

Vocês assinam digitalmente as notificações? (HMAC, RSA, ou outro?)

Qual é a estrutura JSON do webhook? Posso ter um exemplo?

É possível configurar múltiplos webhooks ou apenas um endpoint?

Vocês notificam sobre rejeições, devoluções ou PIX pendentes?

5 Segurança e Conformidade

Requisitos regulatórios, conformidade e boas práticas

Quais são os requisitos de segurança? (IP whitelist, Rate limiting, Encryption, outros?)

Vocês oferecem sandbox/ambiente de testes? Por quanto tempo e com quais limitações?

Qual é o processo de homologação? Preciso passar por aprovação técnica antes de ir a produção?

Vocês fazem audit de segurança nas integrações antes de liberar para produção?

Há requisitos de PCI-DSS, LGPD ou regulamentações específicas da BACEN que preciso cumprir?

Como funciona a criptografia de dados em trânsito? (TLS 1.2+, TLS 1.3?)

Vocês disponibilizam logs de acesso à API? Posso auditá-los?

Qual é a política de retenção de dados? Quanto tempo vocês guardam histórico de transações?

Vocês possuem certificação ISO 27001 ou similar?

6 Reconciliação e Relatórios

Extração de dados e auditoria de transações

Como faço reconciliação entre o que minha plataforma registra e o que vocês recebem?

Vocês oferecem API para consultar saldo, extrato ou transações históricas?

Posso fazer consulta de PIX por período, chave, status ou valor?

Vocês disponibilizam arquivo de movimentação (OFX, CNAB, ou similar)?

Qual é o delay entre a transação acontecer e estar disponível na API de consulta?

Vocês oferecem dashboard ou relatórios na sua plataforma? Que informações contêm?

7 Suporte Técnico e Escalação

Canais de comunicação e resolução de problemas

Qual é o SLA de suporte? (Horário comercial, 24/7, tempo de resposta?)

Qual é o canal de contato para problemas técnicos? (Email, telefone, chat, portal, Slack?)

Vocês têm um time de developer relations ou integração que posso contatar?

Existe documentação técnica completa, exemplos de código e tutoriais?

Vocês oferecem treinamento técnico, webinars ou sessões de integração?

Existe um fórum de desenvolvedores ou comunidade para tirar dúvidas?

Como vocês comunicam mudanças, atualizações ou degradação de serviço?

8 Escalabilidade e Performance

Limites técnicos e comportamento sob carga

Qual é a capacidade máxima de transações por segundo que a API suporta?

Vocês implementam rate limiting? Se sim, qual é o limite (requisições/segundo ou por hora)?

Qual é o tempo de resposta esperado da API em condições normais? (p50, p95, p99?)

Vocês garantem SLA de disponibilidade? Qual é o percentual (99%, 99.9%)?

Existe um status page ou dashboard de monitoramento da API?

9 Prazos, Contratação e Cancelamento

Cronograma e termos comerciais

Qual é o tempo total de ativação? (Abertura conta + certificado A1 + liberação PIX API)

Há contrato de integração separado ou tudo está no contrato da conta corrente?

Qual é a cláusula de término? Posso cancelar a integração quando quiser ou há multa?

Há período de teste gratuito, redução de tarifa ou trial period?

Qual é a margem de antecedência para notificação de mudanças de termos ou preços?

10 Análise de Custos Totais (TCO)

Discriminação completa de despesas

Qual é a mensalidade da conta PJ? Há custo de manutenção?

Qual é o custo por transação PIX recebida? (em R$ ou %?)

Há custo de setup, integração ou ativação?

Qual é o custo anual do certificado A1?

Há outras taxas ou custos escondidos? (transferência, saque, consulta, etc.)

Vocês oferecem desconto por volume de transações? A partir de qual volume?

💡 DICAS IMPORTANTES:

✓ Peça por escrito — Não confie apenas em informações verbais. Solicite propostas, termos técnicos e respostas por email.

✓ Escalação — Se o gerente não souber responder, peça para falar com: Time de Integração, Gerente de Produtos PIX, ou Suporte Técnico.

✓ Homologação — Deixe claro que vocês precisam de ambiente de testes completo e funcional antes de ir para produção.

✓ Documento de Requisitos — Considere levar um documento com os requisitos técnicos da plataforma. Isso facilita para o banco entender exatamente o que vocês precisam.

✓ Referência Técnica — Mencione que vocês já trabalham com BB PIX API v2 e mTLS para que escalem corretamente.

📋 Checklist PIX - Banco do Brasil

Compartilhar Checklist