Atualizações de Produto - Detalhada | Setembro

💳 [Open Finance] Ajuste nas mensagens de aviso para cartões de crédito

O que mudou As mensagens de aviso para cartões de crédito que estão indisponíveis ou sem consentimento agora ficam sempre visíveis (antes apareciam apenas uma vez por semana). Além disso, a mensagem passa a ser mais específica, informando claramente qual é a situação em cada caso.

Por que isso é importante Evita dúvidas de clientes e times de suporte sobre a razão do alerta. Dá mais transparência sobre o status real de cada cartão.

O que você precisa saber

• A mensagem de aviso será exibida continuamente.
• O texto foi ajustado para diferenciar os cenários:
  • Sem consentimento: “Credit card X não possui consentimento do usuário.”
  • Indisponível: “Credit card X está indisponível para o usuário.”

Impacto Mais clareza para clientes e suporte, reduzindo questionamentos e confusões sobre o status dos cartões.

🏦 [Santander OF] Ajuste na paginação de transações

O que mudou A lógica de paginação foi atualizada para corrigir um comportamento que causava loops infinitos durante a sincronização de transações do Santander. Antes, o contador de páginas só era incrementado quando o page-size era igual a 1000, mas o Santander força o uso de 100, o que impedia o avanço da paginação e resultava em timeout da Lambda (800s) após centenas de páginas processadas. Por que isso é importante Com o novo ajuste, a paginação passa a contar corretamente todas as páginas, independentemente do page-size, garantindo que grandes volumes de dados sejam processados sem falhas ou interrupções. O que você precisa saber

• Nova lógica adaptativa de limites:
  • Conectores com page-size = 100 → até 500 páginas.
  • Conectores com page-size = 1000 → até 100 páginas.
• Limite total de segurança adicionado: 200.000 transações por execução.
• Sem breaking changes — todas as integrações existentes continuam funcionando normalmente.

Impacto Usuários do conector Santander (e similares) agora conseguem recuperar um volume muito maior de transações históricas sem risco de timeout.

🧩 [Open Finance] Prevenção de duplicidades e revisão de instituições elegíveis

O que mudou Para evitar conexões duplicadas (mesmo CPF ou CNPJ), adicionamos novos validadores e atualizamos a lista de instituições compatíveis com a flag que impede a criação de múltiplos itens para o mesmo usuário. O que foi feito

• Adição dos conectores Nubank PF e Nubank PJ à whitelist de instituições com bloqueio de duplicidade.
• Revisão das instituições que podem ser incluídas com segurança.
• Análise de clientes que já utilizam a flag de bloqueio para identificar possíveis impactos.
• Documentação atualizada nos guias com a lista completa das instituições incluídas.

Impacto Itens duplicados (com mesmo CPF ou CNPJ) não serão mais criados para os conectores Open Finance Nubank PF e PJ. Resumo de instituições e critérios atuais BTG PF: CPF, senha Itaú PF: agência, conta Bradesco PF: agência, conta Santander PF: QR Nubank PF: QR Inter PF: QR C6 PF: não compatível Safra PF: agência, conta XP Banking PF: QR Mercado Pago PF: CPF, senha Banco do Brasil PF: agência, conta

https://docs.pluggy.ai/docs/item#/avoiding-duplicates

🧪 [Sandbox] Fluxo de múltipla alçada agora funcional no widget

O que mudou O fluxo de múltipla alçada no conector Sandbox Open Finance foi corrigido e agora está funcionando também dentro do widget. Antes, o fluxo só suportava um único CPF, o que impedia clientes de testar cenários que exigem múltiplas autorizações. Como o fluxo de múltipla alçada funciona Esse fluxo simula um cenário em que, para acessar os dados de uma conta, o item precisa ser aprovado por outra pessoa — geralmente outro sócio da empresa. Para testar:

• Crie um item no Sandbox utilizando um dos CPFs de teste listados na documentação.
  • O item não retornará contas imediatamente.
  • O campo statusDetail indicará que as contas precisam de autorização.
• Atualize o item.
  • Dependendo do CPF utilizado, as contas poderão ou não ser retornadas após a autorização simulada.

Por que isso é importante Permite que clientes testem e validem fluxos com múltiplas autorizações, simulando casos reais de uso do Open Finance. O que você precisa saber

• O widget agora é compatível com esse fluxo.
• A documentação foi atualizada com as instruções completas para teste.

Impacto O fluxo de múltipla alçada está disponível no ambiente Sandbox, facilitando a validação de integrações que exigem aprovação de mais de um usuário. https://docs.pluggy.ai/docs/sandbox#7---open-finance-flow

💳 [Open Finance] Correção de status em transações futuras de cartão de crédito

O que mudou Corrigimos um comportamento que fazia com que transações futuras de cartão de crédito fossem exibidas com o status POSTED (lançadas) em vez de PENDING (pendentes). Isso ocorria porque algumas instituições financeiras retornavam um billId para transações que pertenciam à próxima fatura — mesmo quando essa fatura ainda não estava disponível ou fechada. O que foi implementado

• Nova lógica aplicada às sincronizações recentes (current bill):
  • Quando o campo billPostDate é futuro em relação à data atual, o sistema remove o billId dessa transação.
  • Dessa forma, a transação é corretamente marcada como PENDING.
  • Para transações passadas, o billId é mantido, preservando o status POSTED.
• A lógica não afeta sincronizações históricas, evitando que transações antigas mudem indevidamente de status.

Por que isso é importante Essa correção garante que as transações sejam exibidas com o status correto, refletindo a realidade da fatura. Isso melhora a precisão na conciliação e no merge de transações, além de evitar confusão para usuários que viam lançamentos futuros como se já estivessem concluídos. Impacto

• Transações futuras passam a aparecer como PENDING (sem billId).
• Transações passadas mantêm o status POSTED.
• A lógica de merge funciona corretamente, diferenciando transações pendentes e concluídas.
• Nenhum breaking change: a alteração afeta apenas a lógica interna de sincronização recente.

🧮 [Open Finance] Correção no cálculo do campo closingBalance

O que mudou Implementamos uma correção no cálculo do campo closingBalance dos conectores de Open Finance. Antes, o valor retornado não refletia corretamente o saldo contábil (saldo contabil), o que gerava inconsistências. O que foi ajustado

• O campo closingBalance agora retorna a soma de: → availableBalance + blockedBalance
• Esse ajuste garante que o valor represente o saldo contábil real da conta.
• A documentação foi atualizada para refletir o novo comportamento.

Por que isso é importante A correção garante precisão nos saldos exibidos pelos conectores Open Finance. Impacto

• closingBalance agora reflete corretamente o saldo contábil.
• Melhora na consistência dos dados financeiros.
• Nenhum breaking change: apenas ajuste de cálculo e documentação.

⚡ [API] Suporte a deep links como oauthRedirectUri

O que mudou A Pluggy API agora permite o uso de deep links como oauthRedirectUri nos fluxos de autenticação. Antes, o redirecionamento após o login era possível apenas para URLs web, mas com essa melhoria o usuário pode voltar direto para dentro do aplicativo mobile após concluir o fluxo OAuth. Por que isso é importante Essa atualização simplifica a experiência de autenticação em aplicativos mobile, permitindo que o redirecionamento aconteça de forma fluida e integrada — sem precisar abrir uma página externa no navegador. O que você precisa saber

• Os deep links são aceitos como URIs de redirecionamento no fluxo OAuth.
• A documentação foi atualizada com instruções e exemplos de uso.

Impacto Melhor experiência de autenticação em apps mobile e maior flexibilidade para desenvolvedores que utilizam OAuth. https://docs.pluggy.ai/docs/oauth-support-guide#/

✨ [Open Finance] Novos conectores disponíveis

Temos três novos conectores Open Finance disponíveis em produção, atualmente em fase BETA:

• Dock PF → Produtos: Accounts, Transactions, Identity
• QI SCD PF → Produtos: Accounts, Transactions, Loans, Identity
• QI SCD PJ → Produtos: Accounts, Transactions, Loans, Identity

O que você precisa saber

• Todos os conectores estão disponíveis em produção.
• A fase BETA indica que podem ocorrer pequenos ajustes ou otimizações de performance.