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:
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 sendoconnector.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)
CREDIT_CARDS — faturas e parcelas
CREDIT_CARDS — faturas e parcelas
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.INVESTMENTS — escopo do sync
INVESTMENTS — escopo do sync
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.OPEN BANKING INTERNACIONAL — escopo AIS
OPEN BANKING INTERNACIONAL — escopo AIS
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_LIMITEDe não recebem novas tentativas periódicas dessa estratégia incompatível. - Em qualquer provedor, trate
PARTIAL_SUCCESSestatusDetailpor 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
productsestatusDetailpor produto são reportados. - Limites do Open Finance — cotas mensais por produto.