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

Atualizações de Produto | Setembro/2026

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

  • Parcelas futuras de cartão de BTG e Mercado Pago passam a ter data futura e deixam de ser excluídas e recriadas a cada fechamento de fatura.
  • Novo endpoint GET /items/{id}/resources e o campo hasResourcesPendingAuthorization no Item: saiba o que o consentimento cobre e o que ainda falta o usuário autorizar no banco.
  • GET /connectors mais informativo: productCoverage diz quais sub-produtos cada instituição serve, e health.incidents traz os incidentes ativos. A página de status também pode ser consultada por API.
  • operationType em transações de cartão, incluindo PAGAMENTO_FATURA para pagamentos de fatura.
  • Correções sistêmicas em exclusões indevidas de compras de cartão, consentimentos pendentes de aprovação no Sicredi e transações duplicadas no Bradesco PJ via Open Finance.

22 mudanças · 3 breaking · 5 categorias

Breaking changes e depreciações3

Deprecated

Santander Cartões (798) deslistado do Open Finance

O conector não aceita mais novos consentimentos nem a criação de novos items.
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. Até lá, o prazo de migração continua aberto.

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.

🚀 Novas Features8

New

Recursos declarados no consentimento: GET /items/{id}/resources

Novo endpoint que lista os recursos que a instituição declarou para o consentimento do item, exatamente como ela reportou (resourceId, type e status). O status usa o vocabulário do Open Finance: AVAILABLE, UNAVAILABLE, TEMPORARILY_UNAVAILABLE e PENDING_AUTHORISATION. Um recurso UNAVAILABLE ou PENDING_AUTHORISATION explica um produto ausente. O novo campo resourcesCollectedAt do Item indica se a lista já foi lida: se ele estiver preenchido e a lista vier vazia, a instituição não declarou recursos; se for null, a lista ainda não foi obtida. Só vale para Open Finance: itens de conectores diretos retornam uma página vazia, sem erro.
GET /items/{id}/resourcesGET /items/{id}open finance
New

Recursos pendentes de autorização: hasResourcesPendingAuthorization

O Item passa a dizer se a instituição tem recursos esperando autorização, um caso típico de conta PJ que aguarda um segundo aprovador. true indica pelo menos um recurso PENDING_AUTHORISATION, false indica que a lista foi lida e nada está pendente, e null indica que a lista ainda não foi lida ou que o conector não é Open Finance. Para saber quais recursos estão pendentes, use GET /items/{id}/resources?status=PENDING_AUTHORISATION. No statusDetail, investimentos e empréstimos pendentes passam a gerar os avisos INV_002 e LOAN_002. Já disponível nos SDKs Node (pluggy-sdk 0.91.0), Java (1.14.0) e .NET (0.43.0).
GET /items/{id}GET /items/{id}/resourcesopen finance
New

Cobertura de produtos por instituição: productCoverage

GET /connectors passa a informar quais sub-produtos cada instituição Open Finance serve, com os nomes do diretório do Open Finance (por exemplo CREDIT_OPERATIONS:LOANS, INVESTMENTS:FUNDS, INVESTMENTS:BANK_FIXED_INCOMES). products diz se a instituição serve investimentos; productCoverage diz quais. Quando o campo não vem, a cobertura é desconhecida, como nos conectores diretos.
GET /connectorsopen finance
New

Incidentes ativos por conector: health.incidents

GET /connectors e GET /connectors/{id} passam a trazer os incidentes ativos de cada conector, com título, tipo, produto afetado, severidade, estado e link para a página de status. O campo só aparece quando há incidente. Repare que health.status pode continuar ONLINE com incidentes abertos. Com isso, você pode avisar o usuário na tela de seleção de banco antes que ele tente conectar uma instituição com problema.
GET /connectorsGET /connectors/{id}
New

Página de status consultável por API

status.pluggy.ai agora responde em GET /api/status, com o snapshot completo (saúde de cada conector, histórico de 90 dias e incidentes com timeline), e em GET /api/summary, com o status geral. Não precisa de autenticação. O identificador de cada instituição é o mesmo id de GET /connectors.
New

operationType em transações de cartão de crédito

Transações de cartão via Open Finance passam a trazer em operationType o tipo de transação informado pela instituição, incluindo PAGAMENTO_FATURA. Os pagamentos de fatura que a Pluggy gera a partir das faturas, que antes vinham com operationType: null, também passam a vir como PAGAMENTO_FATURA. A partir de agora, operationType pode ser informado pela instituição ou inferido pela Pluggy.
GET /transactionscartão de créditoopen finance
New

Novos campos em transações de cartão (Open Finance)

creditCardMetadata passa a trazer paymentType (A_VISTA ou A_PRAZO), billPostDate (a data em que a instituição lançou a transação na fatura, como ela informou) e transactionDateTime (data e hora da transação, normalizadas em ISO-8601). billPostDate vem null quando a transação ainda não foi lançada em uma fatura ou quando a instituição não informa a data. Nas transações do tipo OUTROS, o detalhe informado pela instituição passa a vir em operationTypeAdditionalInfo. O campo date não muda. Os campos são preenchidos a partir das próximas atualizações, sem retroatividade: nas transações antigas a chave não aparece, e chave ausente e null significam o mesmo.
GET /transactionscartão de créditoopen financeaplica a: transações sincronizadas a partir de 28/09/2026
New

Impostos em transações de renda variável (Open Finance)

Os impostos informados pela instituição nas transações de investimentos de renda variável passam a vir em expenses.other. O IRRF continua em incomeTax.
GET /investments/{id}/transactionsopen finance

💳 Pagamentos3

Improved

Simulação de falha síncrona no Pix Automático (sandbox)

Use o valor R$ 404,04 em qualquer chamada de Pix Automático no conector Sandbox Open Finance (primeiro pagamento, autorização ou agendamento recorrente) para receber na hora o erro SANDBOX_FORCED_SYNC_ERROR. Nada é gravado e nenhum webhook é disparado, o que simula o caso em que o banco nunca responde. Assim você consegue testar esse fluxo, que é diferente de um erro de negócio como saldo insuficiente.
pagamentos
Improved

Nova tela de consentimento da Pluggy para Pix simples (sandbox)

No conector Pluggy Bank (sandbox), o Pix simples ganhou uma tela de consentimento da Pluggy, para você testar o fluxo de pagamento de ponta a ponta. O pagamento é concluído normalmente, sem ficar travado em CONSENT_AWAITING_AUTHORIZATION.
pagamentos
Improved

Pix Automático: limite de tentativas no agendamento

Quando a criação de um pagamento agendado falhava antes de a instituição responder, o agendador criava um novo pagamento com erro a cada poucos minutos, sem código de erro. Agora a falha vem com o código AUTOMATIC_PIX_SCHEDULE_UNEXPECTED_ERROR e há um limite de tentativas por ciclo. A correção vale para todos os conectores em produção.
pagamentos

🛠️ Incidentes resolvidos1

Improved

Bradesco Empresas (conector direto)

O conector teve instabilidade recorrente, com indisponibilidade entre 04 e 06/09, e os items terminavam em PARTIAL_SUCCESS porque a etapa de dados de pagamento (paymentData) falhava em toda execução. As duas coisas foram corrigidas.

🐛 Correções6

Fixed

Compras de cartão pendentes não são mais excluídas perto do fechamento da fatura

No Itaú PF (601) e no Nubank (612), compras pendentes próximas da data de fechamento eram excluídas e reapareciam dias depois. Nos conectores Open Finance, uma parcela datada fora da sua fatura podia levar à exclusão de compras ainda abertas. Os dois casos foram corrigidos.
Fixed

Sicredi: consentimento pendente de aprovação não é mais tratado como erro de conexão

No Sicredi PF (661) e no Sicredi Empresas (627), consentimentos de conta conjunta ou com múltiplos aprovadores que ainda esperam aprovação retornavam CONNECTION_ERROR, como se o consentimento tivesse sido revogado. Agora o item fica em USER_AUTHORIZATION_PENDING, e você pode orientar o usuário a concluir a aprovação no banco.
connector 661connector 627open finance
Fixed

Bradesco PJ (Open Finance): lançamentos diários de encargos duplicados

O Bradesco PJ (609) reenvia diariamente com um novo identificador os lançamentos de encargos e tarifas ainda em aberto, e cada atualização gravava uma nova cópia. Novas duplicatas deixaram de ser criadas.
connector 609open finance
Fixed

Valor da parcela em compras parceladas no cartão (Open Finance)

No Itaú, no Banrisul e no Inter, algumas compras parceladas vinham com o valor total da compra em cada parcela, em vez do valor da parcela. Agora cada parcela traz o seu próprio valor.
Fixed

Itaú Empresas (conector direto): saldo nos lançamentos AUT MAIS

Para quem tem a recuperação de lançamentos AUT MAIS ativada, as aplicações e os resgates automáticos (APL APLIC AUT MAIS e RES APLIC AUT MAIS) passam a vir com balance, como os demais lançamentos do extrato.
Fixed

Faturas de cartão disponíveis a partir do fechamento (Inter PF)

No Inter PF (823), as faturas de cartão via Open Finance passam a chegar assim que a instituição as publica no fechamento, e não mais só na data de vencimento. Os demais conectores Open Finance vão receber a mudança de forma progressiva.
connector 823cartão de créditoopen finance

📚 Documentação1

Improved

SCR na referência da API

GET /items/{id}/scr agora está documentado na referência pública, com os schemas de resposta, os códigos de erro e um novo guia em Open Finance → SCR. O endpoint continua disponível para os times que têm o recurso habilitado.
GET /items/{id}/scropen finance