Já vi dezenas de projetos de integração financeira atrasarem meses. E quase nunca foi por falta de bons desenvolvedores.
Isso costuma surpreender quem está começando um projeto. A expectativa é de que, com um bom time e uma boa API, a integração "é só conectar". Na prática, integrar com um banco é uma das coisas mais traiçoeiras da engenharia de software e os maiores desastres de tecnologia bancária da última década provam isso.
Integração bancária não é "chamar uma API"
Conectar-se a um banco não é consumir um endpoint e pronto. É lidar com um conjunto de detalhes que só quem já operou de verdade conhece:
- CNAB. O formato de troca de arquivos entre empresas e bancos tem variações, particularidades por instituição e regras que não perdoam. Um campo no lugar errado quebra o lote inteiro.
- Conciliação. Garantir que o que saiu de um lado bateu com o que chegou do outro. Sem uma estratégia de conciliação desde o início, as divergências só aparecem no fechamento, no pior momento possível.
- Janelas de processamento. Bancos operam em janelas e lotes. Ignorar esses horários é receita para transações presas e retornos fora de ordem.
- Retornos que não batem. O caso mais comum e mais subestimado. O que o sistema faz quando o retorno do banco não corresponde ao que foi enviado? É aqui que a maioria dos projetos descobre, tarde demais, que não tinha um plano.
Nenhum desses pontos aparece na demo. Todos aparecem em produção, sob volume real. E é exatamente aí que os prazos estouram.
O caso que todo gestor de tecnologia deveria conhecer: o TSB
Em abril de 2018, o banco britânico TSB migrou cerca de 5 milhões de contas da plataforma do antigo controlador (Lloyds) para um novo sistema. No papel, estava tudo pronto.
Na noite da virada, o banco caiu. Clientes ficaram trancados fora das próprias contas. Alguns chegaram a ver saldo e transações de outros clientes. Os canais digitais saíram do ar. Na primeira semana, as reclamações explodiram e a espera para falar com um atendente passou de uma hora.
O problema não foi resolvido em dias. Levou cerca de oito meses para estabilizar. O custo total ficou em torno de £330 milhões, o banco perdeu aproximadamente 80 mil clientes e ainda foi multado em £48,65 milhões pelos reguladores britânicos.
O ponto que interessa aqui: o TSB não tinha falta de bons desenvolvedores, nem de orçamento. O que derrubou o banco foram os detalhes: migração e customização acontecendo em paralelo, dados que não se comportaram como o esperado e cenários que só se revelaram sob carga real.
E não foi um caso isolado: o Deutsche Bank
Se você acha que foi azar de um banco só, o exemplo se repetiu com um dos maiores bancos do mundo. Em 2023, o Deutsche Bank concluiu a migração dos cerca de 12 milhões de clientes do Postbank, movendo dezenas de bilhões de registros para seus sistemas.
Semanas depois, os clientes relatavam ficar sem acesso ao próprio dinheiro por semanas, com débitos rejeitados e pendências travadas. O regulador alemão recebeu milhares de reclamações, classificou a situação como "inaceitável" e chegou a instalar um fiscal dentro do banco para acompanhar a resolução. Internamente, bônus foram cortados.
Dois bancos enormes, anos de preparação, times robustos e o mesmo resultado. A lição é difícil de ignorar.
O que esses casos ensinam
A conclusão é sempre a mesma: integração bancária não quebra no código. Ela quebra nos detalhes que ninguém te avisa: Dados que não batem, situações extremas, comportamentos que só aparecem em produção, com volume e dados reais.
Se os maiores bancos do mundo, com todo o recurso disponível, tropeçam nesses detalhes, o diferencial de um projeto bem-sucedido não é ter mais gente ou mais orçamento. É ter alguém que já viveu esses detalhes antes e sabe onde eles se escondem.
A pergunta que separa quem entrega de quem atrasa
Por isso, a primeira pergunta que eu faço em um projeto novo nunca é "qual API?". É:
"O que acontece quando o retorno não bate?"
A resposta a essa pergunta revela na hora se o projeto foi pensado para o mundo real ou só para a demonstração. É ela que separa quem vai entregar de quem vai atrasar.
Na T4tech Consultoria, essa é a rotina. Já construímos integrações para um dos maiores bancos da América Latina. O que para muitos times é território desconhecido, para nós é o dia a dia.
O que checar antes de começar uma integração bancária
Se você tem um projeto pela frente, comece garantindo respostas claras para estes pontos:
- Estratégia de conciliação definida desde o primeiro dia, não deixada para o fim.
- Tratamento de retornos e exceções: o que o sistema faz quando o banco responde algo inesperado.
- Janelas de processamento mapeadas e respeitadas no fluxo.
- Idempotência e segurança: garantir que uma requisição duplicada não vire prejuízo.
- Plano de rollback: como voltar atrás com segurança se algo der errado no go-live.
- Testes com volume e dados realistas, não apenas no ambiente controlado.
- Observabilidade: visibilidade sobre cada etapa, para achar o problema pequeno antes que ele vire incidente.
Perguntas frequentes
O que é CNAB?
É o padrão de troca de arquivos entre empresas e bancos (remessa e retorno), usado em cobranças, pagamentos e conciliação. Tem variações por banco, o que torna a integração mais delicada do que parece.
Por que a conciliação é tão crítica?
Porque é o que garante que o que foi enviado corresponde ao que foi processado. Sem uma estratégia de conciliação desde o início, as divergências se acumulam silenciosamente e só aparecem no fechamento.
Quanto tempo leva uma integração bancária?
Depende do escopo, mas o maior risco de prazo não está no desenvolvimento em si, está no tratamento das exceções, dos retornos e dos cenários de produção. Subestimar isso é a causa mais comum de atraso.
Como reduzir o risco de estourar o prazo?
Tratando os detalhes como requisito desde o planejamento: conciliação, retornos, janelas e rollback. E, sempre que possível, trabalhando com quem já passou por esses cenários antes.
Está com um projeto de integração parado?
Se a sua integração travou ou você quer evitar que trave? Fale com a T4tech. Em uma conversa rápida a gente identifica onde está o risco e o caminho mais curto para destravar.
