A Malvo é uma API de agregação e categorização de dados de Open Finance. Há um único host de API, https://api.malvo.io, e a autenticação é sempre via header X-API-KEY. Esta página reúne os canais de suporte, a página de status e o que incluir num chamado para que a investigação seja rápida.
A Malvo não faz iniciação de pagamentos (ITP) — somente recepção e categorização de dados. Eventos e campos de pagamento existem nas respostas apenas por compatibilidade de wire, mas nunca são acionados.

​
Canais

Página de status

Incidentes em tempo real, conectores afetados e ETA de restabelecimento. Assine por e-mail (e opcionalmente SMS) para ser avisado quando algo mudar.

Dashboard

O canal oficial de contato e abertura de chamados. Pelo Dashboard você acessa o suporte com o contexto da sua Application já vinculado.
  • Página de status — status.malvo.io. Publica incidentes por conector afetado, com janelas de manutenção e ETAs de restabelecimento. Oferece assinatura por e-mail e, opcionalmente, SMS. Consulte-a antes de abrir um chamado: muitos 5xx, SITE_NOT_AVAILABLE e connector/status_updated → OFFLINE correspondem a um incidente já em andamento.
  • Suporte pelo Dashboard — malvo.io/dashboard. É por onde você fala com a equipe de suporte e abre chamados. Como você já está autenticado, a sua Application e o clientId chegam ao time sem precisar repassá-los manualmente.
  • Canal Slack (Enterprise). Clientes Enterprise recebem um canal compartilhado no Slack para atualizações ao vivo e contato direto. O acesso é provisionado pela equipe Malvo durante o onboarding do contrato.
Sem SLA público. Os prazos de resposta e disponibilidade são negociados por contrato — fale com a equipe pelo Dashboard ou pelo canal Slack Enterprise.

​
Como abrir um chamado

Quanto mais completo o relato, mais rápido o diagnóstico. Para qualquer problema de conexão, o itemId é obrigatório — sem ele não há como analisar o erro.
Para problemas de conexão, inclua sempre o itemId. Ele identifica a conexão específica entre um usuário e um conector; sem ele a equipe não consegue investigar.
1

Identifique o itemId (obrigatório p/ conexão)

O itemId (UUID) está no objeto do Item (GET /items/{id} → campo id) e em todos os webhooks item/* e transactions/*. Guarde-o no seu lado, indexado por clientUserId.
2

Anexe o requestId / x-request-id

Toda resposta da API traz o identificador da requisição no header x-request-id e no campo requestId do corpo. Copie-o da chamada que falhou — ele liga o seu erro ao log da Malvo.
3

Registre o timestamp (ISO-8601)

Informe o horário da tentativa que falhou em ISO-8601 com fuso, por exemplo 2026-06-21T14:32:10.000Z. Isso delimita a janela de logs a investigar.
4

Copie o código e a mensagem de erro

Pegue o code e a message da origem correta: item.error (Item em erro), o callback onError do widget, o corpo JSON da API ou o payload do webhook. Ramifique sempre pelo code/codeDescription, nunca pelo texto da message.
5

Inclua o status HTTP e o body (falhas de API)

Para erros de chamada à API, anexe o status HTTP retornado e o corpo completo da resposta (o envelope GlobalErrorResponse). Veja a tabela de ações por status abaixo.
6

Aponte o connectorId (se for específico do conector)

Se o problema parece restrito a uma instituição, inclua o connectorId (inteiro). Ele ajuda a correlacionar com a saúde do conector e com incidentes na página de status.
7

Descreva os passos de reprodução e a frequência

Liste os passos para reproduzir e diga se acontece sempre ou de forma intermitente. Anexe um screenshot quando o erro for do widget.

​
Checklist do chamado

​
Status HTTP → ação rápida

Antes de abrir o chamado, confira se o status retornado já tem uma ação direta: Para o envelope de erro completo, os codeDescription estáveis e os erros de validação com errors[], veja /concepts/errors. Para a lista de códigos de erro de conexão (INVALID_CREDENTIALS, USER_AUTHORIZATION_PENDING, …) e como recuperar cada um, veja /reference/error-codes.

​
SLA

A Malvo não publica números de SLA. Prazos de resposta, disponibilidade e cobertura de suporte são negociados por contrato. Para condições específicas, fale com a equipe pelo Dashboard ou, se você for cliente Enterprise, pelo canal Slack compartilhado.

Acompanhar status

Assine alertas por e-mail/SMS e veja incidentes por conector em status.malvo.io.

Abrir um chamado

Fale com o suporte pelo Dashboard, com a sua Application já vinculada ao contexto.