Este changelog registra as mudanças da API REST da Malvo — endpoints de dados, inteligência, enriquecimento e webhooks, todos servidos no host único https://api.malvo.io. Para mudanças nos SDKs do Connect Widget, veja Changelog dos SDKs.
​
Catálogo multi-provedor ampliado
Um novo provedor passou a integrar o catálogo operacional da Malvo. O contrato público permanece único: o connectorId selecionado determina internamente a rota operacional adequada ou o sandbox local.O que está disponível
  • Catálogo adicional restrito a Connectors Open Finance (isOpenFinance=true), sincronizado e isolado por provedor, com saúde e produtos atualizados pelo diretório.
  • Criação e atualização de Item por autorização regulada, OAuth, MFA em dois passos e ações pendentes no aplicativo da instituição; Connectors diretos não são expostos.
  • Accounts, Transactions (incluindo paymentData quando disponível), Credit Cards/Bills, Investments, Investment Transactions, Identity e Loans no mesmo shape normalizado da Malvo.
  • Paginação por cursor em GET /v2/transactions e reconciliação reativa por webhooks, incluindo transactions/deleted e item/deleted.
  • Respostas de MFA são transitórias: seguem para o provedor durante a chamada e não são persistidas no Item.
  • Uma coleta parcial preserva os dados válidos, mas só libera os webhooks de conclusão quando todas as famílias solicitadas estiverem prontas.
A Malvo continua sendo data-only: conectores exclusivamente de pagamento não são anunciados e supportsPaymentInitiation permanece false. Consulte GET /connectors em runtime, pois a disponibilidade e os produtos variam por instituição.

Entender os provedores

Veja como o catálogo dinâmico e a separação por provedor funcionam.

Criar um Item

Use o mesmo ciclo de vida para credenciais, OAuth, MFA e atualizações.
​
Open Banking internacional em 29 novos países
Malvo Open Banking internacional com as bandeiras dos 30 países atendidosA Malvo expandiu sua conectividade regulada com Open Banking AIS em 29 novos países. Somados aos 347 conectores do Open Finance Brasil, o catálogo de produção agora reúne 5.262 conectores em 30 países, todos acessíveis pelo mesmo contrato de API.

30 países

Brasil e mais 29 mercados internacionais em um único catálogo.

5.262 conectores

4.915 internacionais e 347 brasileiros no retrato de lançamento.

Uma única API

Items, Accounts e Transactions normalizados no mesmo contrato Malvo.
Cobertura por país
Contagem do catálogo de produção em 27 de julho de 2026, sem conectores de sandbox ou ocultos. Um connector representa uma instituição em um país e contexto de usuário; a mesma marca pode aparecer em mais de um connector. Como o diretório é dinâmico, consulte GET /connectors em runtime para obter a cobertura efetiva da sua aplicação.
O que a integração entrega
  • ACCOUNTS e TRANSACTIONS via AIS, incluindo saldos no objeto Account.
  • Autorização por redirect OAuth, sem coleta de senha bancária pela Malvo ou pelo integrador.
  • Criação, renovação e sincronização no mesmo ciclo de vida de Item já usado no Brasil.
  • Polling e scheduler operados pela Malvo, com webhooks emitidos após a persistência dos dados.
  • Filtros por countries, connectorTypes e connectorIds no Connect Widget e nos SDKs.
  • PIS e iniciação de pagamentos permanecem fora do produto público.

Explorar connectors

Entenda o catálogo dinâmico, os filtros por país e as capacidades por connector.

Conectar uma instituição

Implemente o fluxo OAuth internacional pelo Connect Widget ou pela API.
​
Cobrança PAYG sem mensalidade mínima
A Malvo passou a usar uma única tarifa pay as you go por faixas graduais, sem mensalidade mínima, franquia ou seleção de plano.
  • 1 a 1.000 consentimentos: R$ 4,00 por consentimento.
  • 1.001 a 3.000 consentimentos: R$ 3,80 por consentimento.
  • 3.001 a 5.000 consentimentos: R$ 3,10 por consentimento.
  • 5.001 consentimentos em diante: R$ 2,05 por consentimento.
  • Cada preço se aplica somente aos consentimentos de sua própria faixa; cruzar um limite nunca reduz a fatura.
  • Um consentimento é uma nova conexão no mês ou um item existente atualizado no mês, com deduplicação por item-mês.
  • Aplicações SANDBOX continuam sem gerar cobrança.
  • Cadastro, Dashboard e Billing não oferecem mais escolha ou troca de plano.
  • O fluxo para adicionar um meio de pagamento pode ser reiniciado normalmente após o cliente cancelar e voltar da página segura da Stripe.
Veja Billing para a regra completa e exemplos de cálculo.
​
Lançamento da API v1
Primeira versão pública da API REST da Malvo. Tudo é servido no host único https://api.malvo.io, com autenticação por header X-API-KEY em cada endpoint.Produtos de dados
  • Accounts — contas bancárias (BANK: checking/savings) e de cartão (CREDIT), com bankData e creditData. Lista por itemId, recupera por id e extratos via GET /accounts/{id}/statements.
  • Transactions — endpoint atual cursor-based GET /v2/transactions (paginação pelo campo next, page size de 500 controlado pelo servidor), retrieve por id e PATCH /transactions/{id} para corrigir a categoria. Até 12 meses de histórico.
  • Credit Cards & Bills — faturas via GET /bills (por accountId) e GET /bills/{id}, com financeCharges e payments; compras parceladas expostas por transação em creditCardMetadata.
  • Investments — posições via GET /investments (por itemId), cobrindo FIXED_INCOME, MUTUAL_FUND, EQUITY, ETF, COE, SECURITY e OTHER.
  • Loans — operações de crédito com cronograma de parcelas e encargos.
  • Identity — dados cadastrais do titular do Item.
Categorização
  • Catálogo de 130 categorias em até três níveis, com categoryId estável de 8 dígitos (faça join sempre pelo id, nunca pelo nome).
  • Category Rules (POST/GET /categories/rules), escopadas por cliente; correções via PATCH /transactions/{id} alimentam o classificador e criam regra automaticamente.
Webhooks
  • Eventos de Item, Transactions e Connectors, autenticados por headers customizados e allowlist de IP; não há HMAC nem stream consent/* dedicado.
  • Entrega com até 9 tentativas (3 fases) quando o receiver não retorna 2XX em até 5 segundos; idempotência por eventId e reconciliação noturna.
Saldo sincronizado
  • GET /accounts/{id}/balance retorna o último saldo persistido pela sincronização, com timestamp de coleta e representação fiel de conjuntos multimoeda.
Inteligência & Enriquecimento
  • POST /book — Item Insights (KPIs agregados por Item).
  • POST /categorization — Enrich de transações próprias do cliente (categorização e identificação de merchant).
  • POST /recurring-payments — detecção de pagamentos recorrentes (assinaturas, salários, contas). Todas servidas no mesmo host único, sem iniciação de pagamento.
Disponibilidade na data do lançamento
  • Em 2026-06-21, estes recursos eram oferecidos nos antigos planos Connect e Scale. A tarifa vigente está documentada em Billing.

​
Depreciações

​
Depreciação do page-based GET /transactions
O endpoint page-based GET /transactions (paginação por page/pageSize, envelope page/total/totalPages/results) está deprecado e será removido após 2026-12-31. Ele continua implementado até lá apenas para compatibilidade.Migração: use o endpoint atual cursor-based GET /v2/transactions e pagine pelo campo next (uma query string pronta para anexar) até receber next: null. O page size é fixo em 500 e controlado pelo servidor — não há parâmetro pageSize na v2. Faça a sincronização incremental com createdAtFrom, dirigida por webhooks.