Quanto tempo leva integrar uma API bancária: o prazo real.

É a segunda pergunta de toda empresa que decide integrar, logo depois do preço. E é uma das poucas em que a resposta honesta não é "depende" — dá para quebrar o prazo em etapas, e a maior parte delas está documentada pelos próprios bancos.

A resposta curta: entre 3 e 10 semanas por banco, quando o caminho é API direta. A faixa é larga porque a variável dominante não é o desenvolvimento — é o tempo de resposta da instituição financeira.

As cinco etapas de um projeto de integração:

Quanto leva cada etapa, segundo a documentação pública:

O que a documentação dos bancos exige:

No Itaú, autenticação por OAuth 2.0 com mTLS, certificado dinâmico próprio do banco com validade de 365 dias e token de acesso de 5 minutos. Dois detalhes que custam tempo: o sandbox não usa mTLS, então o mecanismo real só é testado em produção, e apenas o usuário administrador pode gerar credenciais — se a pessoa certa não estiver disponível, o projeto para.

No Bradesco, o processo é em quatro passos por e-mail com assunto padronizado, e o certificado exigido é A1 ICP-Brasil em PFX com validade mínima de 4 meses. Certificado perto do vencimento reprova a homologação — e é uma das causas mais bobas e mais frequentes de retrabalho.

Os cinco atrasos mais comuns:

1. Esperar o banco. É a variável dominante e a que você menos controla.

2. Documento societário. A carta de habilitação precisa de assinatura do sócio administrador, e o modelo muda por banco — o Itaú usa planilha em vez de carta.

3. Certificado digital. Validade insuficiente, formato errado ou CNPJ errado. Verifique na semana zero, não na quarta.

4. Sandbox que não reflete produção. Parte do trabalho só aparece depois que o ambiente já está valendo.

5. Conta PJ com múltiplos sócios. O item mais subestimado — veja a seguir.

O gargalo específico da conta pessoa jurídica:

Há um problema de integração corporativa que não é técnico e não tem solução padronizada: a jornada de consentimento não foi desenhada para empresas com múltiplos sócios e alçadas.

Quando a conta exige assinatura conjunta, ou quando o contrato social distribui poderes, não existe fluxo único que dê conta. Os números mostram o tamanho: a taxa de conclusão das jornadas fica entre 50% e 60%, com algumas instituições abaixo de 40%. Quase metade de quem começa não termina.

Na prática, o prazo de um projeto PJ precisa de uma folga que projetos de pessoa física não precisam. Mapeie a estrutura de alçadas antes de cravar a data de entrega.

O que dá para adiantar antes de assinar:

Todos os itens abaixo podem ser resolvidos antes do contrato, e cada um economiza dias ou semanas.

• Certificado digital em dia. Tipo, formato e validade. Se faltar menos de quatro meses, renove antes de começar.

• Mapa de alçadas da conta. Quem assina, quem aprova, quem é administrador no portal do banco.

• Sócio administrador avisado. Ele vai assinar documento em pelo menos uma etapa.

• Lista de contas e bancos fechada. Cada instituição é um processo. Saber quantas são evita repactuar prazo no meio.

• Ambiente técnico liberado. Faixas de IP e firewall. Descobrir bloqueio de rede na semana da homologação custa um ciclo inteiro.

• Um responsável único do seu lado. Projetos de integração morrem em ping-pong entre financeiro, TI e comercial.

Direto com o banco ou via plataforma.

A conta raramente fecha a favor da integração direta acima de dois ou três bancos. Não pelo primeiro projeto — pelo décimo, e principalmente pela manutenção, que é permanente e não aparece na estimativa inicial.

Um cronograma realista:

Perguntas frequentes:

Qual é o prazo mínimo realista?

Com certificado em dia, alçadas resolvidas e um banco com onboarding self-service, uma conexão de leitura pode estar em produção em duas semanas. Esse é o melhor cenário, não a média.

O que atrasa mais: o banco ou o desenvolvimento?

O banco, com folga. O desenvolvimento de uma integração de extrato é estimado em 10 a 20 dias úteis. A espera por liberação, homologação e documentação costuma consumir mais tempo que a implementação.

Preciso de certificado ICP-Brasil?

Depende do banco. Bradesco e Santander exigem A1 ICP-Brasil. O Itaú usa certificado dinâmico próprio. Inter e Sicredi usam outro formato. Confirme antes, porque cada tipo tem prazo de emissão diferente.

Quanto tempo leva para adicionar um banco depois que o projeto já roda?

Via Open Finance ou plataforma de orquestração, é incremental. Via API direta, é praticamente um projeto novo, porque nada da integração anterior se reaproveita. É a diferença que a Openi elimina.

E se eu quiser participar do Open Finance com estrutura própria?

Além da autorização do Banco Central, há a certificação de conformidade da OpenID Foundation, com recomendação de submissão dois meses antes e sem SLA garantido. É um caminho de meses, não de semanas.