A Malvo é uma camada de dados de Open Finance e Open Banking: você conecta as contas bancárias dos seus usuários e recebe, de volta, dados financeiros normalizados e categorizados através de uma API REST simples. Contas, transações, cartões, investimentos, empréstimos e dados cadastrais chegam no mesmo formato público, conforme os produtos oferecidos por cada instituição e provedor. No Brasil, a conectividade regulada usa Open Finance Brasil. Na Europa e no Reino Unido, a Malvo oferece conectividade AIS (Account Information Service) para contas, saldos e transações. A cobertura internacional habilitável abrange 31 países, mas o catálogo de bancos é dinâmico: consulte GET /connectors em tempo de execução em vez de manter uma lista fixa.
A Malvo faz apenas agregação de dados. Não há iniciação de pagamentos (ITP), Pix, boletos ou transferências. Os campos relacionados a pagamento existem nas respostas só por compatibilidade e são sempre inertes (por exemplo, supportsPaymentInitiation: false).

​
O modelo em três passos

A integração com a Malvo segue sempre o mesmo fluxo:
1

Connect Widget

Seu backend gera um connectToken (válido por 30 minutos) e abre o Connect Widget em https://malvo.io/connect?token=.... O usuário escolhe a instituição e autoriza o acesso — via redirect OAuth do Open Finance.
2

Item

Ao final do consentimento, a Malvo cria um Item: a representação de uma conexão entre um usuário e uma instituição. O Item mantém o vínculo com o consentimento e é o ponto de entrada para todos os dados.
3

Dados normalizados

Com o X-API-KEY no servidor, você lê os dados do Item já normalizados e categorizados: GET /accounts, GET /v2/transactions, GET /bills, GET /investments, e assim por diante.
A fonte da verdade sobre o estado de um Item são os webhooks da Malvo (item/created, item/updated, …). O callback onSuccess do widget é best-effort — o usuário pode fechar a aba antes dele disparar.
No fluxo internacional, a Malvo consulta sessões e dados pelo scheduler e emite seus próprios webhooks após persistir o resultado.

​
Por onde começar

Quickstart

Do zero ao primeiro Item: credenciais, apiKey, connectToken, widget e leitura dos dados.

Connect Widget

O frontend hospedado que conecta os bancos dos seus usuários em qualquer plataforma.

Referência da API

Base URL, autenticação, envelope de erro, paginação e o playground interativo.

SDKs

React (@malvo/react-connect), script global, React Native, Flutter e mais.

Webhooks

A fonte da verdade sobre o ciclo de vida dos Items e a chegada de novos dados.

​
Produtos de dados

Cada Item pode coletar um ou mais dos seguintes produtos, conforme o consentimento concedido:

Accounts

Contas correntes, poupança e pré-pagas: saldo disponível, saldo bloqueado e dados da conta.

Transactions

Lançamentos normalizados e categorizados automaticamente. Lidos via GET /v2/transactions.

Credit Cards & Bills

Cartões de crédito, limites, faturas (/bills) e parcelamentos no Open Finance Brasil.

Investments

Posições de investimento ativas, com saldo e rendimento no Open Finance Brasil.

Loans

Contratos de crédito, parcelas e condições no Open Finance Brasil.

Identity

Dados cadastrais do titular no Open Finance Brasil: nome, documentos e contatos.
A lista de produtos de um Item é definida pelo conector e pelo consentimento do usuário. Os conectores internacionais anunciam somente ACCOUNTS e TRANSACTIONS; os demais produtos dependem da cobertura do Open Finance Brasil. Consulte sempre connector.products.