FAQ
Changelog
Service statusPluggy.aiLogin
Back to All

Atualizações de Produto - Detalhada | Setembro

8 months ago by Ingrid Oliveira

💳 [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.