Todo Item declara em products[] o conjunto de produtos que coleta. Esses valores aparecem em GET /connectors, POST /connect_token, POST /items e no objeto Item. São case-sensitive e sempre em inglês.
A Malvo é agregação de dados + categorização. Não existem produtos de iniciação de pagamento (ITP) — sem PIX/Boleto, sem Smart Transfers, sem PIX Automático. Campos como supportsPaymentInitiation permanecem nas respostas apenas por compatibilidade de wire, mas são sempre false e inertes.

O enum products

Valores exatos, conforme aparecem na API:
Solicite apenas valores presentes em connector.products. Informar um produto no request não faz a instituição ou o provedor passar a oferecê-lo.

Tabela de referência

As duas modalidades usam autorização regulada com redirect. A disponibilidade abaixo descreve o contrato atual da Malvo; a cobertura efetiva continua sendo connector.products em runtime.
A lista de products é específica daquele conector e contexto. A modalidade internacional materializa conectores pessoais e empresariais separados quando o ASPSP oferece ambos. Consulte sempre GET /connectors?isOpenFinance=true — a cobertura é dinâmica por país, instituição, ambiente e contrato.

Particularidades por produto (preserve no consumo)

Transações de cartão são atualizadas diariamente, mas os detalhes completos só ficam disponíveis após o fechamento da fatura. Faturas abertas não aparecem até serem fechadas ou vencidas, e o billId de uma transação só é atribuído quando a fatura existe na instituição. Algumas transações aparecem apenas na listagem da fatura, nunca no fluxo de transações.Comportamentos por instituição: BTG Pactual (614) retorna todas as parcelas futuras como PENDING já na primeira conexão; XP Banking (602) retorna o valor total da compra em vez das parcelas individuais; a maioria das demais retorna apenas a primeira parcela de compras futuras.
O sync inicial retorna somente investimentos ativos. Investimentos resgatados aparecem em syncs posteriores com status TOTAL_WITHDRAWAL. Notas de corretagem não são expostas. As “Caixinhas” do Nubank e os “Cofrinhos” do PicPay são normalizados como investimentos CDB.
Nesta integração, os conectores anunciam somente ACCOUNTS e TRANSACTIONS. Contas de tipos diferentes podem ser normalizadas como Account, mas a Malvo não promete as semânticas de fatura, investimento, empréstimo ou identidade dos produtos brasileiros.

Limites de coleta

  • Brasil: histórico inicial de até 365 dias e limites mensais da rede por (CPF/CNPJ + instituição + produto); veja Limites do Open Finance.
  • Open Banking internacional: a primeira coleta usa a estratégia de maior histórico disponível e a janela real depende do ASPSP; atualizações usam sobreposição de 90 dias e, nos ASPSPs compatíveis, tentam reconciliar o histórico completo a cada 30 dias. ASPSPs que rejeitam a janela máxima usam a maior janela compatível, sinalizam HISTORY_LIMITED e não recebem novas tentativas periódicas dessa estratégia incompatível.
  • Em qualquer provedor, trate PARTIAL_SUCCESS e statusDetail por produto sem apagar os dados válidos da sincronização anterior.

Relacionado

  • Conectores — cobertura dinâmica e seleção por país/produto.
  • Items — onde products e statusDetail por produto são reportados.
  • Limites do Open Finance — cotas mensais por produto.