---

changes: listar-as-suas-conexoes-get-v2-items: endpoints: [GET /v2/items] products: [api] applies_to: times com o recurso "List items" habilitado tickets: [TRIN-2070] janelas-de-atualizacao-configuraveis: products: [api] applies_to: configuração feita pela Pluggy sob demanda tickets: [TRIN-2360] open-finance-proxy-disponivel-para-conexoes-de-alto-volume: products: [open finance] applies_to: times com o recurso OF Proxy habilitado tickets: [TRIN-2359] transactions-updated-agora-e-enviado-em-blocos-de-ate-400-id: endpoints: [GET /transactions] products: [webhooks] tickets: [TRIN-2454] correcao-em-patch-webhooks-id: endpoints: [PATCH /webhooks/{id}] products: [webhooks] tickets: [TRIN-2445] mensagens-de-erro-mais-claras-no-payment-request: products: [pagamentos] tickets: [DX-142] melhorias-no-mecanismo-anti-exclusao-de-transacoes: products: [webhooks] tickets: [TRIN-2429] fatura-de-cartao-duplicada-quando-o-billid-muda-de-provisori: endpoints: [GET /bills] products: [cartão de crédito, open finance] tickets: [TRIN-2428] bradesco-pj-connector-direto-transacoes-que-deixavam-de-ser: endpoints: [GET /transactions] products: [open finance] tickets: [TRIN-2485, TRIN-2442, TRIN-2433] sinal-do-valor-em-pagamentos-recorrentes-de-cartao-de-credit: endpoints: [POST /recurring-payments] products: [cartão de crédito] tickets: [TRIN-2488] itau-empresas-connector-directo-investimentos-voltando-a-sin: products: [investimentos] tickets: [TRIN-2443] itau-lancamentos-aut-mais-em-tempo-real: products: [open finance]

---

🚀 Novas Features

• → Listar as suas conexões: GET /v2/items — Até agora não era possível listar items pela API e cada integração precisava guardar os 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 — Agora é possível configurar em quais horários os seus items são atualizados automaticamente, em vez de depender apenas do ciclo padrão. Útil para quem precisa detectar movimentações em horários específicos do dia. A configuração é feita pela Pluggy sob demanda — fale com o Suporte com os horários que fazem sentido para o seu caso.
• → Open Finance Proxy disponível para conexões de alto volume — O Open Finance Proxy deixa de estar restrito a conexões que já tinham batido o limite de recursos da instituição (RESOURCES_LIMIT_EXCEEDED) e passa a atender também conexões elegíveis por volume, como as que acumulam mais de 100 mil transações. 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.

---

🔔 Webhooks

• → transactions/updated agora é enviado em blocos de até 400 ids — Em atualizações grandes, o webhook enviava todos os 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} — O endpoint retornava 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.

---

💳 Pagamentos

• → Mensagens de erro mais claras no payment request — As mensagens retornadas quando uma solicitação de pagamento falha foram revisadas para indicar de forma mais direta o que aconteceu e o que fazer.

---

🐛 Correções

• → Melhorias no mecanismo anti-exclusão de transações — Quando uma instituição para de retornar temporariamente transações que já existiam, elas eram marcadas como excluídas e reapareciam dias depois, gerando buracos no extrato e webhooks de exclusão indevidos. A exclusão coordenada passa a ser suspensa nesses cenários, evitando que uma instabilidade do banco vire perda de dados no seu lado.
• → Fatura de cartão duplicada quando o billId muda de provisório para definitivo — Antes do fechamento, a instituição retorna um 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 — Corrigidos três casos que causavam perda de lançamentos: a consulta por período subcapturava o volume mensal e perdia transações já efetivadas em sincronizações históricas e parciais; lançamentos idênticos repetidos no mesmo dia eram descartados como duplicados; e uma transação que deveria aparecer três vezes era retornada uma só.
• → Sinal do valor em pagamentos recorrentes de cartão de crédito — Na API de Recurring Payments (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.
• → Itaú Empresas (Connector Directo): investimentos voltando a sincronizar — Corrigida a falha em massa que impedia o retorno de investimentos desde o final de julho.
• → Itaú: lançamentos AUT MAIS em tempo real — Os lançamentos do AUT MAIS passam a ficar disponíveis em tempo real, sem o atraso que existia antes.