[Atualizações de produto - Detalhada] Agosto-25

Estamos sempre evoluindo nossos conectores, SDKs e APIs para garantir mais confiabilidade, simplicidade e transparência nas integrações. Nesta edição, você encontrará:

1. Novos recursos que reduzem fricção na integração e melhoram a experiência do usuário.
2. Melhorias técnicas que aumentam a precisão dos dados e a estabilidade dos fluxos.
3. Ajustes importantes que simplificam a manutenção e tornam os conectores mais consistentes.

Nosso objetivo é que você tenha acesso cada vez mais rápido, seguro e confiável às informações financeiras — e que possa confiar plenamente nos dados retornados pelos nossos conectores.

🔄 [EfiPay] Contas disponíveis já na criação da conexão

O que mudou

Antes, as contas e transações do conector EfiBank eram sincronizadas apenas no dia seguinte à criação da conexão. Agora, as contas ficam disponíveis imediatamente no momento em que a conexão é criada.

Por que isso é importante

Essa melhoria reduz o tempo de espera e melhora a experiência do usuário, permitindo acesso mais rápido às informações das contas.

O que você precisa saber

• A recuperação das contas agora acontece já na criação do item.
• Utilizamos a API PIX para trazer essas informações.
• A sincronização inicial segue estável após a mudança.
• Foram adicionados dois novos escopos de token, mas não há alterações que quebrem integrações existentes, desde que as credenciais sejam atualizadas corretamente.

📘 Confira o passo a passo atualizado na documentação do EfiBank Empresas.

⚙️ [Open Finance] Melhorias no endpoint resources do Sicoob

O que mudou

Alguns conectores de Open Finance (incluindo o Sicoob) utilizam um endpoint para buscar recursos de um linkId. De acordo com a documentação oficial, as instituições podem levar até 5 minutos para retornar os dados — nesse período, podem responder com status 202 e objeto vazio ({}).
Agora, implementamos uma lógica de retentativa automática: se a API responder com status 202 ou 503, o conector continuará tentando até que os recursos sejam recuperados ou até atingir o limite de 5 minutos.

Por que isso é importante

• Reduz falhas no fluxo de criação de itens.
• Garante mais confiabilidade e menos frustração no onboarding.
• Melhora a experiência do usuário mesmo em cenários de atraso das instituições.

O que você precisa saber

Em alguns casos, o fluxo de criação pode levar um pouco mais de tempo, mas isso evita falhas diretas.
Não há mudanças que quebrem integrações existentes.

📘 Mais detalhes podem ser encontrados na documentação atualizada sobre o fluxo de sincronização.

🛠️ [Open Finance] Ajuste no campo products dos conectores

O que mudou

O campo products nos dados dos conectores agora reflete com precisão quais produtos cada conector de Open Finance realmente suporta. Antes, apenas Investimentos e Empréstimos eram filtrados conforme os recursos disponíveis, enquanto outros produtos (como Cartões de Crédito, Contas e Identidade) eram sempre exibidos — mesmo quando não estavam disponíveis.

Por que isso é importante

Essa inconsistência gerava confusão: por exemplo, o conector 99Pay aparecia como se suportasse cartões de crédito, quando na prática não oferecia esse recurso. Isso resultava em tentativas de conexão falhas e uma experiência ruim para os clientes.

O que você precisa saber

• O campo products agora verifica dinamicamente todos os tipos de produto com base nos availableResources retornados pela API do Iniciador.
• Além de Investimentos e Empréstimos, também filtramos Cartões de Crédito, Contas e Identidade.
• Não há mudanças estruturais na API — apenas maior precisão dos dados.
• Integrações existentes continuam funcionando normalmente, mas agora com informações mais confiáveis para a tomada de decisão.

🕒 [Open Finance] Nova lógica de retentativa para sincronização histórica de transações

O que mudou

Alguns conectores de Open Finance apresentavam um problema crítico: a primeira sincronização histórica de transações podia retornar um array vazio, devido ao tempo que a instituição financeira precisava para processar os dados. Isso resultava em:

• Status de execução como “sucesso parcial”
• Usuários visualizando apenas a última semana de transações
• Geração de tickets de suporte
• Risco de perda definitiva de dados históricos

Para resolver isso, implementamos uma lógica abrangente de retentativa automática para sincronizações históricas.

Como funciona a nova lógica

• Detecção automática: se uma sincronização histórica retornar vazio, a conta é marcada para retentativa.
  Retentativas diárias: a partir do dia seguinte, o sistema força novas sincronizações históricas (sempre buscando até 1 ano atrás) até recuperar todos os dados.
• Controle inteligente: não há retentativa no mesmo dia, evitando execuções desnecessárias.
• Monitoramento completo: o processo é acompanhado por notificações no Sentry, garantindo visibilidade dos padrões de retentativa.
• Arquitetura limpa: a lógica foi centralizada em uma função dedicada, com padronização de datas no formato DD/MM/AAAA.

O que você precisa saber

• Usuários passarão a receber automaticamente o histórico completo de transações, sem risco de perda de dados.
• A execução pode levar um pouco mais de tempo em dias de retentativa.
• Pode haver dúvidas dos usuários sobre o “aparecimento repentino” de transações antigas — por isso é importante comunicar que se trata de uma melhoria no processo.

🆔 [Open Finance] Novos campos no endpoint de identidade

O que mudou

O endpoint /identity recebeu duas melhorias importantes:

• Filtro de contas com consentimento: agora, o campo financialRelationships.accounts retorna apenas as contas para as quais o usuário deu consentimento explícito — alinhando o comportamento com o endpoint /accounts.
• Informações adicionais de endereço: alguns bancos (como BTG e Itaú) enviam dados extras, como apartamento ou complemento, no campo additionalInfo. Esses dados agora passam a ser mapeados para o objeto final de Address, evitando perda de informações úteis.

Por que isso é importante

• Garante consistência entre os endpoints /identity e /accounts, reduzindo confusão para os usuários.
• Enriquece os dados de endereço disponíveis, melhorando a qualidade das informações apresentadas.

O que você precisa saber

• Contas sem consentimento explícito não aparecerão mais no financialRelationships.accounts.
• Pode haver dúvidas de clientes que notarem a ausência dessas contas, mas isso é um comportamento esperado e alinhado às boas práticas de consentimento.

📘 Mais detalhes disponíveis na documentação de referência e no guia de identidades.

📉 [Rico] Descontinuação dos fluxos de Contas e Transações

O que mudou

Os fluxos de Contas (ACCOUNTS) e Transações (TRANSACTIONS) foram descontinuados no conector Rico, que passa a focar exclusivamente em seu caso de uso principal: Investimentos.

Por que isso é importante

• Simplifica a manutenção ao remover endpoints e caminhos de código que não eram utilizados.
• Mantém os dados de Identidade e Investimentos sólidos e confiáveis.

O que você precisa saber

• Os passos, serviços, mapeadores e testes relacionados a ACCOUNTS/TRANSACTIONS foram removidos.
• Não há impacto nos fluxos de Investimentos ou Identidade — incluindo Transações de Investimento, que seguem funcionando normalmente.
• Chamadas que incluírem ACCOUNTS/TRANSACTIONS não retornarão mais esses dados para este conector.

📘 Mais detalhes disponíveis na documentação de cobertura de conectores.

💳 [Bradesco PJ] Melhorias nos dados de pagamentos

O que mudou

Foram implementadas melhorias significativas no conector Bradesco PJ para corrigir dados de pagamentos ausentes e aumentar a performance na recuperação dessas informações.

Por que isso é importante

Essas mudanças fortalecem a conciliação de itens do Open Finance e de conexões diretas, que dependem de alta taxa de sucesso nesse produto.

O que você precisa saber

• Boleto:
  • /Velocidade de recuperação aumentada em 10x.
  • Lógica de correspondência de transações aprimorada → maior taxa de sucesso.
• PIX enviado:
  • Velocidade de recuperação aumentada em 10x.
  • Lógica de correspondência de transações aprimorada → maior taxa de sucesso.
• Limite de transações:
  • Correção do limite de 10K transações para recuperação de dados de pagamento.
  • Antes, itens acima desse limite não retornavam os dados corretamente.

Impacto

Mais confiabilidade e velocidade na conciliação de boletos e PIX enviados, garantindo dados mais completos e consistentes.