v2026.08Atualizações de Produto | Agosto/2026
Confira as principais novidades e melhorias da Pluggy em agosto de 2026.
Destaques de agosto
- Novo piso de frequência de atualização para client IDs novos — é um breaking change pequeno e defensivo, com ampliação sob demanda via Suporte.
- Novo endpoint
GET /v2/itemspara listar as suas conexões com paginação por cursor, disponível sob acordo comercial. - Webhooks mais robustos:
transactions/updatedagora é enviado em blocos de até 400 ids, e cada evento cabe em uma única chamada. - Janelas de atualização configuráveis para casos que precisam de sincronização em horários específicos.
- Correções sistêmicas em transações de Bradesco PJ, faturas duplicadas de cartão e proteção contra exclusões indevidas durante instabilidade dos bancos.
16 mudanças · 4 breaking · 4 categorias
Breaking changes e depreciações4
Frequência mínima de atualização passa a ter um padrão para client IDs novos
minUpdateFrequencyAllowedInHours. Ao pedir uma atualização antes desse intervalo, a API responde CLIENT_IS_UPDATING_BEFORE_ALLOWED_FREQUENCY. É uma proteção contra sobrecarga, não um corte de escopo.O que fazer: se a sua integração precisa de atualizações mais frequentes, fale com o Suporte — o limite é ajustável por time, caso a caso. Client IDs já existentes não são afetados.
GET /transactions (v1) passa a rejeitar mais de 500 ids no parâmetro ids
400 IDS_PARAMETER_EXCEEDS_MAX_LENGTH, o mesmo comportamento que a v2 já tinha. Antes, o v1 aceitava a chamada sem validar.O que fazer: divida a consulta em blocos de até 500 ids. Se você consome os transactionIds do webhook transactions/updated, isso já vem resolvido — veja a mudança em Webhooks.
Relembrando — anunciado em junho: transição para cursor pagination no endpoint de transações
O que fazer: migre para o endpoint paginado por cursor. Contas criadas antes de junho de 2026 continuam sem ser afetadas; avisaremos com antecedência antes de qualquer mudança para elas.
Relembrando — anunciado em julho: conectores diretos para pessoa física em descontinuação
O que fazer: migre essas conexões para o conector de Open Finance equivalente. Não há migração automática — o usuário final precisa refazer a conexão, e o histórico do item direto não é transferido.
🚀 Novas Features3
Listar as suas conexões: GET /v2/items
itemId na própria base. O novo endpoint devolve os items do seu time, do mais recente para o mais antigo, com paginação por cursor e os mesmos campos de GET /items/{id}. Aceita os filtros clientUserId e connectorId. É opt-in: vem desativado por padrão e, sem a liberação, a chamada responde 403 LIST_ITEMS_FEATURE_NOT_ENABLED — listar permite enumerar todos os items do time, um acesso mais amplo do que buscar um item por id, então a habilitação passa por acordo comercial.Janelas de atualização configuráveis
Open Finance Proxy disponível para conexões de alto volume
RESOURCES_LIMIT_EXCEEDED) e passa a atender também conexões elegíveis por volume. A elegibilidade é definida pela Pluggy e o acesso é habilitado por time, mediante avaliação. O que fazer: se você tem conexões com muitas contas ou um volume alto de transações e vê falhas de limite de recursos, fale com o Suporte para avaliarmos a habilitação para o seu time.🔔 Webhooks2
transactions/updated agora é enviado em blocos de até 400 ids
transactionIds em um único evento, e o array não cabia em uma chamada a GET /transactions?ids=. Agora 600 transações atualizadas geram dois webhooks (400 + 200), cada um com o seu transactionsCount, e cada evento cabe em uma única chamada, podendo ser consumido diretamente sem quebrar a lista.Correção em PATCH /webhooks/{id}
500 ao atualizar apenas os headers (mesmo assim aplicando a alteração) e 400 dizendo que o webhook já existia quando url ou event eram enviados, porque a validação de unicidade comparava o registro com ele mesmo.💳 Pagamentos1
Mensagens de erro mais claras no payment request
🐛 Correções6
Melhorias no mecanismo anti-exclusão de transações
Fatura de cartão duplicada quando o billId muda de provisório para definitivo
billId provisório baseado na data de vencimento projetada; após a consolidação, o definitivo. Quando a data de vencimento mudava nessa troca, as duas faturas não eram unificadas e a fatura aparecia duplicada. A comparação agora tolera pequenos ajustes de data.Bradesco PJ (Connector Direto): transações que deixavam de ser retornadas
Sinal do valor em pagamentos recorrentes de cartão de crédito
POST /recurring-payments), uma cobrança recorrente de cartão vinha com averageAmount positivo e podia ser lida como receita. O valor agora segue a convenção bancária, como a documentação sempre indicou: despesa negativa. As mesmas recorrências continuam sendo detectadas — apenas o sinal muda.

