Auto Top-Up

Recarrega o saldo automaticamente quando cair abaixo de um limiar definido por você. Útil pra apps em produção que não podem parar de fazer chamadas IA por falta de crédito.

Como ativar

1. Vá em /dashboard/billing.
2. Clique Adicionar cartão e preencha os dados. O cartão é tokenizado pelo Asaas — Tokia armazena apenas o token, nunca o número.
3. No card "Auto Top-Up", marque Ativar recarga automática.
4. Configure:
   • Threshold (R$): quando saldo cair abaixo, dispara recarga. Mínimo R$ 5.
   • Valor da recarga (R$): quanto cobrar do cartão a cada vez. Entre R$ 10 e R$ 5.000.
   • Cartão: qual cartão usar (caso tenha múltiplos).
5. Clique Salvar configuração.

Quando o cron roda

• Cron auto_topup_check roda a cada 1 hora.
• Cooldown de 30 minutos entre charges do mesmo user — evita cobrar de novo se o webhook Asaas atrasar.
• Após 3 falhas consecutivas (cartão recusado, expirado, sem saldo), Auto Top-Up é auto-desabilitado. Cliente recebe email e precisa atualizar o cartão pra reativar.

Notificações

• Email "Recarga automática R$ X executada" após cada cobrança bem-sucedida.
• Email "Saldo baixo" quando atinge threshold (1x/dia max).
• Email "Cartão precisa ser atualizado" após 3 falhas.
• Email "API keys suspensas" se Auto Top-Up desabilitar e saldo zerar.

Como desativar

Em /dashboard/billing, desmarque Ativar recarga automática e clique Salvar. Você pode também remover o cartão — isso desativa Auto Top-Up automaticamente.