Procurando a documentação anterior?Acesse v1.docs.pluggy.ai
PluggyDocs
Changelog
v2026.10

Atualizações de Produto | Outubro/2026

Confira as principais novidades e melhorias da Pluggy em outubro de 2026.

Destaques de outubro

  • Atenção: o primeiro pagamento do Pix Automático não pode mais cair no mesmo dia do startDate, e o client secret passa a ser exibido uma única vez.
  • Novo conector Open Finance: Azimut, para pessoa física.
  • PIX por biometria (Jornada Sem Redirecionamento): o pagador vincula a conta uma vez e confirma os pagamentos seguintes com biometria, sem ir ao banco.
  • Saldo da conta de origem em Smart Transfers e no PIX por biometria, com a Jornada Otimizada.
  • Pagamentos agendados da conta corrente via Open Finance, começando pelo Itaú, e saldo em tempo real mais completo em GET /accounts/{id}/balance.
  • Mais visibilidade sobre a sua integração: Logs e métricas de requisições no Dashboard, explorador de execuções, e novas ferramentas no MCP da Pluggy.

22 mudanças · 3 breaking · 6 categorias

Breaking changes e depreciações3

Deprecated

Pix Automático: o primeiro pagamento não pode cair no mesmo dia do startDate

Desde 23/10, POST /payments/requests/automatic-pix devolve 400 AUTOMATIC_PIX_INVALID_FIRST_PAYMENT_DATE quando a data do firstPayment é igual ao startDate. Se o firstPayment vier sem date, ele é liquidado no dia da autorização, e nesse caso o startDate não pode ser hoje. A mesma validação roda em POST /payments/intents: solicitações já criadas nesse formato recebem o erro ali e precisam ser recriadas. É uma regra do Open Finance: a recorrência só começa depois do pagamento de adesão.

Quem não envia firstPayment não é afetado, e os consentimentos já autorizados continuam funcionando.

O que fazer: envie o startDate pelo menos um dia depois do primeiro pagamento (por exemplo, cobre a adesão hoje e comece a recorrência mensal daqui a um mês).

Deprecated

Client secret exibido uma única vez

O client secret de uma aplicação passa a ser mostrado apenas no momento em que é gerado: na criação da aplicação ou ao clicar em "Gerar novo secret". Depois disso, não é mais possível visualizá-lo no Dashboard.

Integrações que já usam o secret continuam funcionando normalmente.

O que fazer: guarde o secret em um cofre seguro assim que ele for exibido. Se ele se perder, gere um novo pelo Dashboard.

Deprecated

Relembrando — anunciado em junho: transição para cursor pagination no endpoint de transações

Contas criadas a partir de junho de 2026 já usam por padrão o endpoint paginado por cursor, e o endpoint legado (v1) será descontinuado para essas contas em dezembro de 2026, daqui a um mês.

O que fazer: migre para o endpoint paginado por cursor. Contas criadas antes de junho de 2026 continuam sem ser afetadas, e vamos avisar com antecedência antes de qualquer mudança para elas.

📡 Novos Conectores1

New

Azimut (Open Finance)

Novo conector Open Finance para pessoa física (connectorId 805), com contas, transações, cartões de crédito, investimentos, empréstimos e dados de identidade.
connector 805open finance

💳 Pagamentos3

New

PIX por biometria (Jornada Sem Redirecionamento)

Agora você pode cobrar com PIX por biometria. Você cria a solicitação e envia o paymentUrl ao pagador. No primeiro pagamento, ele escolhe o banco, aprova o vínculo e cria uma passkey em pay.pluggy.ai. Nos pagamentos seguintes, no mesmo dispositivo, ele confirma com biometria, sem ser redirecionado ao app do banco. A API permite criar a cobrança, consultar os vínculos e receber webhooks quando um vínculo é autorizado, revogado ou não é concluído. Também está disponível nos SDKs de Node, Java e .NET e no Dashboard, em Pagamentos → Solicitações (novo tipo PIX por biometria) e Pagamentos → Contas vinculadas. É uma primeira versão, ainda sem sandbox: para testar, use um pagamento real de R$ 0,01 de uma conta diferente da do recebedor. Por enquanto a jornada funciona apenas pela página de pagamento da Pluggy. Guias em docs.pluggy.ai, em Pagamentos → PIX por biometria.
pagamentos
Improved

Saldo da conta de origem com a Jornada Otimizada (Smart Transfers)

Ao criar a pré-autorização com linkedJourney: true em POST /smart-transfers/preauthorizations, o usuário autoriza, na mesma aprovação no banco, a leitura do saldo da conta de origem. A pré-autorização passa a trazer dataConsent com o estado da permissão (AWAITING_AUTHORISATION, AUTHORISED ou REJECTED). Com a permissão autorizada, GET /smart-transfers/preauthorizations/{id}/balance devolve o saldo em tempo real e o cheque especial (overdraft). Para revogar só essa permissão, use DELETE /smart-transfers/preauthorizations/{id}/data-consent: a pré-autorização continua ativa. Cada consulta vai à instituição e conta na cota mensal do Open Finance, então consulte logo antes de transferir. Vale apenas para pré-autorizações novas.
POST /smart-transfers/preauthorizationsGET /smart-transfers/preauthorizations/{id}/balanceDELETE /smart-transfers/preauthorizations/{id}/data-consentpagamentosaplica a: pré-autorizações novas
Improved

Saldo da conta vinculada no PIX por biometria

Com linkedJourney: true, o pagador também pode compartilhar o saldo e o cheque especial da conta que vincula, para você consultar antes de cobrar.
pagamentos

🚀 Novas Features4

New

Pagamentos agendados da conta corrente (Open Finance)

Boletos, Pix e débitos que o usuário já agendou no banco passam a aparecer em GET /transactions como transações com status: PENDING e date na data agendada. Quando o pagamento é efetivado, a transação passa a POSTED mantendo o mesmo id (webhook transactions/updated). Se o agendamento for cancelado, a transação é removida (transactions/deleted). Os agendamentos não afetam o balance da conta até serem efetivados. Começa pelo Itaú (601), com até 90 dias à frente, e as próximas instituições entram aos poucos. Atenção: se você consulta com to igual a hoje, não verá os agendamentos. Use um to no futuro.
GET /transactionsconnector 601open finance
New

Saldo em tempo real mais completo: GET /accounts/{id}/balance

Para contas Open Finance, o endpoint passa a devolver blockedBalance, automaticallyInvestedBalance e closingBalance (balance + blockedBalance). Os campos opcionais são omitidos quando a instituição não os informa. A chamada também atualiza bankData.closingBalance e bankData.automaticallyInvestedBalance em GET /accounts/{id}, que antes só mudavam na sincronização seguinte. No Itaú e no Banco do Brasil, balance já inclui a aplicação automática, então balance e automaticallyInvestedBalance trazem o mesmo valor. Disponível em pluggy-node 0.93.0, pluggy-net 0.46.1 e pluggy-java 1.16.1.
GET /accounts/{id}/balanceGET /accounts/{id}open finance
New

SCR no sandbox

Você já pode testar o SCR sem conectar uma conta real: crie um item no conector Sandbox Open Finance (600) com um dos CPFs do sandbox e chame GET /items/{id}/scr. A resposta é sintética, determinística e tem o mesmo formato da produção. Ela não consulta o Bacen e não é cobrada. A feature SCR continua precisando estar habilitada no seu time, e janelas com mais de 60 datas-base são rejeitadas no sandbox.
GET /items/{id}/scrconnector 600open finance
New

Novas ferramentas no MCP da Pluggy

Pelo assistente que você já usa (Claude, ChatGPT, Cursor…), logado com a conta do Dashboard, agora dá para investigar a sua integração sem abrir ticket. get_execution_reports mostra o que cada sincronização de um item trouxe: produtos com dados, vazios ou com falha, e transações criadas, atualizadas e removidas. summarize_api_calls e list_api_calls mostram as chamadas que a sua aplicação fez à API da Pluggy. summarize_of_calls e list_of_calls mostram as chamadas que a Pluggy fez à instituição para cada item, com o status de cada uma (por exemplo, 429 por limite de requisições do banco ou 423 por limite mensal). Cada usuário só vê as aplicações e os itens dos próprios times.
open finance

🖥️ Dashboard5

Improved

Logs e métricas de requisições

Na nova seção Monitorar, a página Logs mostra métricas de chamadas, erros e latência da sua aplicação, com filtros para encontrar uma requisição e o detalhe de request e response para o diagnóstico. A seção reúne também Webhooks e Analisar.
dashboard
Improved

Desempenho da API e do Open Finance na página inicial

O início do Dashboard separa as chamadas que você faz à API da Pluggy das requisições que a Pluggy envia às instituições de Open Finance: volume, distribuição de respostas HTTP, endpoints mais chamados e latência p95 por endpoint. A visão de Open Finance cobre as últimas 24 horas, por aplicação.
dashboardopen finance
Improved

Explorador de execuções

Em Solução de Problemas de Execuções, clique numa execução para ver quais produtos vieram com dados, vazios ou com falha, o que a instituição devolveu (contas, cartões, investimentos…) e as transações criadas, atualizadas e excluídas. Na execução mais recente, o painel também mostra o erro do item e o estado de cada produto. O histórico cobre as últimas 20 execuções do item.
dashboard
Improved

Novidades

O Dashboard ganhou uma área de Novidades, com uma apresentação rápida de cada lançamento e acesso a este changelog.
dashboard
Improved

Monitores (beta)

Na nova página Monitores, você configura alertas sobre a sua integração sem depender do nosso time: crie um monitor a partir de modelos com os valores padrão da Pluggy ou defina métrica, escopo e condição, com uma prévia da série e do limite. Quando o monitor dispara ou se recupera, o aviso chega por email ou Slack, e os alertas ativos e o histórico ficam visíveis no Dashboard. Monitores podem ser silenciados. Disponível nos planos Full e Full Plus; criar e editar monitores e canais exige perfil Owner ou Admin.
dashboardaplica a: planos Full e Full Plus

🛠️ Incidentes resolvidos3

Improved

Cora

O conector esteve indisponível entre 06/10 e 07/10 e com desempenho degradado entre 10/10 e 12/10. A conexão foi restabelecida em 12/10.
conectores
Improved

Banco do Brasil Empresas

Desempenho degradado entre 16/10 e 17/10: conexões com dispositivo pendente de liberação terminavam em UNEXPECTED_ERROR. Elas voltaram a seguir o fluxo de liberação: o conector pede o telefone para o SMS ou deixa o item em USER_AUTHORIZATION_PENDING, com as instruções para liberar o dispositivo no Internet Banking.
conectores
Improved

Sicoob (Open Finance)

A conta corrente não era retornada em parte dos consentimentos entre 28/09 e 27/10. Resolvido em 27/10.
open finance

🐛 Correções3

Fixed

Parcelas futuras e compras pendentes de cartão (Itaú PF e C6, Open Finance)

No Itaú PF (601), as parcelas futuras passam a ser datadas dentro da fatura a que pertencem e não são mais excluídas antes do fechamento dela. No C6 (626), compras pendentes recentes não são mais excluídas e recriadas no fechamento da fatura. A correção vale para compras novas. Atenção: no Itaú PF, a date da parcela futura passa a ser a da fatura, e não a da compra.
Fixed

Investimentos da XP (Open Finance)

As novas posições de investimento da XP (602) deixavam de chegar quando o limite mensal de consultas da instituição se esgotava, por volta da metade do mês. As posições agora chegam em toda atualização, sem esperar a virada do mês.
connector 602open finance
Fixed

Impostos dos fundos de investimento (Open Finance)

Os fundos de investimento vindos de Open Finance passam a trazer taxes (provisão de IR) e taxes2 (provisão de IOF), que antes chegavam como null. Vale para todas as instituições de Open Finance que informam esses valores. As posições existentes são corrigidas na próxima sincronização do item.
open finance