Contas novas: os créditos pré-pagos já estão ativos para times cadastrados a partir de 04/10/2026. Esses times começam direto no modelo pré-pago.Contas existentes: migram em 01/12/2026. Até lá, a cobrança continua no modelo pay as you go com fatura mensal, e nenhuma ação é necessária antes do corte. Veja Migração dos clientes atuais.
Com os créditos pré-pagos, o seu time mantém um saldo em reais (BRL) na Malvo. Cada consentimento faturável de produção é descontado desse saldo no momento em que é registrado, em vez de entrar numa fatura no fim do mês. Você acompanha saldo, recargas e extrato em Dashboard → Faturamento → Saldo e recargas.

​
Créditos não são reembolsáveis

Os créditos pré-pagos não são reembolsáveis. O saldo não é convertido em dinheiro nem devolvido, inclusive em caso de cancelamento da conta ou do contrato. Ele é usado apenas para pagar os consentimentos e as mensalidades contratadas do seu time.
Antes de concluir uma recarga, por cartão ou Pix, e antes de ativar a recarga automática, o Dashboard exibe esse aviso. Para continuar, é preciso marcar a confirmação “Entendo que os créditos não são reembolsáveis”. Recarregue valores compatíveis com o seu consumo previsto.

​
Como funciona o saldo

  • O saldo é mantido pela própria Malvo, em reais (centavos), com um extrato de todas as movimentações: recargas, consumos, recargas automáticas, ajustes e estornos.
  • O valor entra no saldo somente depois da confirmação do pagamento pela Stripe.
  • Cada consentimento faturável é debitado uma única vez por item e por mês, seguindo a mesma definição de consentimento faturável usada hoje.
  • Aplicações SANDBOX nunca consomem saldo.
  • O saldo não fica negativo. A única exceção é uma recarga automática que já esteja em andamento.

​
Preço por consentimento

O preço por consentimento não muda com os créditos pré-pagos. O débito usa o preço marginal da faixa em que aquele consentimento cai dentro do mês do seu time:
As faixas são graduais e reiniciam todo mês. O 1.001º consentimento do mês é debitado a R3,80;os1.000primeiroscontinuamaR 3,80; os 1.000 primeiros continuam a R 4,00. Contas com condição comercial negociada mantêm a sua tabela.

​
Recargas

Recarregue em Dashboard → Faturamento → Saldo e recargas. Apenas proprietários (OWNER) e administradores (ADMIN) do time podem recarregar e alterar a recarga automática. Os demais membros veem o saldo e o extrato.
  • O pagamento é concluído no checkout seguro da Stripe, depois da confirmação de que os créditos não são reembolsáveis.
  • No cartão, o crédito entra assim que o pagamento é aprovado, e o cartão fica salvo para a recarga automática.
  • No Pix, o crédito entra quando a Stripe confirma o pagamento.
Boleto não é aceito para recargas.

​
Recarga automática

A recarga automática evita que o saldo zere e que novas conexões sejam pausadas.
  • Funciona apenas com cartão de crédito salvo. Faça uma primeira recarga com cartão para habilitá-la. Pix não pode ser usado na recarga automática.
  • Padrão: quando o saldo fica abaixo de R20,00∗∗,aMalvocobra∗∗R 20,00**, a Malvo cobra **R 100,00 no cartão salvo. Você pode alterar o limite e escolher o valor entre os pacotes disponíveis.
  • Ativar ou alterar uma recarga automática ativa também exige a confirmação de que os créditos não são reembolsáveis.
  • Teto mensal (opcional): limita o total recarregado automaticamente em cada mês. Ao atingir o teto, a recarga automática pausa até o mês seguinte, e as recargas manuais continuam disponíveis.
Se o banco recusar a cobrança ou exigir autenticação adicional (3DS), a recarga automática não é concluída. Nesse caso, a Malvo avisa o time por e-mail para fazer uma recarga manual.

​
Avisos de saldo

A Malvo avisa o seu time em três níveis, no Dashboard e por e-mail:

​
Saldo zerado

Quando o saldo de um time pré-pago chega a zero:
  • Novas conexões ficam pausadas: a criação de connect tokens e de novos items é recusada com HTTP 402 e codeDescription CREDITS_EXHAUSTED.
  • Também ficam pausadas as sincronizações que gerariam um novo consentimento faturável no mês, ou seja, items que ainda não foram cobrados no mês corrente.
  • Continuam funcionando:
    • as sincronizações de consentimentos já pagos no mês;
    • a leitura dos dados existentes (accounts, transactions, investments etc.);
    • a exclusão de items com DELETE /items/{id}.
  • Assim que uma recarga é confirmada, as novas conexões voltam a funcionar automaticamente.

​
Tratando o erro CREDITS_EXHAUSTED

Ramifique pelo codeDescription, não pela mensagem. Ao receber CREDITS_EXHAUSTED:
  1. Não repita a chamada em loop: ela continuará falhando até a recarga.
  2. Mostre ao usuário final uma mensagem neutra, como “Não foi possível iniciar a conexão agora”.
  3. Alerte a sua equipe para recarregar o saldo no Dashboard, ou ative a recarga automática.
Veja também a referência de códigos de erro.

​
Migração dos clientes atuais

Para os times cadastrados antes de 04/10/2026, a virada para créditos pré-pagos acontece em 01/12/2026:
1

Até 30/11/2026

O consumo continua no modelo pay as you go. A fatura de novembro é emitida normalmente no fechamento do ciclo.
2

Em 01/12/2026

O time passa a usar saldo pré-pago. Faça a primeira recarga para manter a criação de novas conexões em produção.
3

Faturas em aberto

Times com faturas em aberto precisam quitá-las e fazer uma recarga para retomar o acesso de produção.

​
Contas novas (desde 04/10/2026)

Times cadastrados a partir de 04/10/2026 já começam no modelo pré-pago, sem assinatura mensal. Depois do cadastro, o Dashboard leva você a Faturamento → Saldo e recargas. Nesses times, o acesso à produção exige a primeira recarga, em vez de apenas um cartão cadastrado.

​
Próximos passos

Billing

Modelo atual pay as you go e definição de consentimento faturável.

Códigos de erro

Inclui 402 CREDITS_EXHAUSTED.