Um Consent é criado quando um Item se conecta pela primeira vez. Ele registra quais produtos o Item pode acessar e por quanto tempo, refletindo a autorização que o usuário concedeu no aplicativo do banco. No Open Finance Brasil e no AIS europeu/britânico, o consentimento é a autorização para leitura dos dados. Sem uma autorização ou sessão válida, o Item não pode atualizar seus produtos.

​
Consultando consentimentos

  • GET /consents?itemId={itemId} — lista os consentimentos de um Item (envelope paginado).
  • GET /consents/{id} — recupera um consentimento específico.
Não existe um stream de webhooks consent/* dedicado. Mudanças aparecem no recurso e indiretamente como eventos de Item (veja Open Finance e Open Banking).

​
Ciclo de vida

Preserve a grafia britânica AUTHORISED e AWAITING_AUTHORISATION no contrato público.

​
Expiração

  • Brasil: a validade varia por instituição e pode não ter data conhecida pela Malvo.
  • Open Banking internacional: a Malvo solicita a validade configurada, limitada pelo prazo máximo informado pelo ASPSP. A data efetiva é exposta em expiresAt e item.consentExpiresAt quando conhecida.
  • Quando uma autorização expira ou é revogada, o Item vai para um estado que exige ação do usuário (OUTDATED/erro de autorização) e deixa de atualizar dados até o reconsentimento.

​
Renovação — no MESMO Item

Para renovar, dispare PATCH /items/{id} ou abra o Connect Widget em modo de atualização com o mesmo itemId. Quando é necessário novo consentimento, a resposta traz uma nova URL de autorização; o usuário se autentica no banco e a sessão nova substitui a anterior sem trocar o Item.
Nunca crie um Item novo para renovar consentimento. Use o mesmo itemId para preservar IDs de conta, histórico, webhooks e reconciliação. No Brasil, duplicar Items também multiplica o consumo das cotas mensais da rede.

​
Limites mensais do Open Finance Brasil

A rede do Open Finance Brasil impõe limites de consumo por (CPF/CNPJ + instituição + produto), por mês — independentes dos rate limits da API da Malvo. Esta seção e a tabela vinculada não se aplicam ao Open Banking internacional; no AIS internacional, rate limits e disponibilidade variam por provedor/ASPSP e a Malvo respeita Retry-After e backoff.

Tabela completa de limites por produto

Consulte os limites mensais exatos por produto e subrecurso.
Quando uma cota é atingida:
  • A execução termina com executionStatus: PARTIAL_SUCCESS.
  • O produto afetado recebe o warning de código 423 em statusDetail.<produto>.warnings[] (ao lado de códigos como TXN_xxx / INV_xxx).
  • O produto bloqueado volta a funcionar automaticamente no mês seguinte.
Orientações para o integrador:
  • Não crie múltiplos Items para o mesmo CPF/instituição — isso multiplica o consumo das cotas.
  • Ao receber 423 / PARTIAL_SUCCESS, mostre um aviso amigável; nunca tente novamente de forma agressiva.
  • Para atualizações pontuais, prefira POST /items/{id}/refresh em vez de criar um Item novo.

​
Privacidade e o direito de revogar

Conformidade obrigatória (LGPD/GDPR e regras locais). Sua integração deve sempre oferecer ao usuário uma ação de “Desconectar banco / Revogar consentimento”, disponível a qualquer momento. Essa ação chama DELETE /items/{id}.Ao excluir o Item, GET /items/{id} passa a retornar 404 e os dados vinculados deixam de estar disponíveis na API. A Malvo tenta encerrar também o consentimento/sessão upstream, sem bloquear a exclusão local se o provedor estiver indisponível: a revogação é primeiro registrada em uma fila durável e então repetida até o provedor aceitá-la. Oriente o usuário a revogar no próprio banco quando precisar de confirmação independente.

​
Próximos passos

Open Finance

Como funciona o fluxo de redirecionamento e a semântica dos dados.

Items

Ciclo de vida do Item, estados e caminhos de recuperação.