Tokia
Entrar
Documentação
⌘K

Auto Top-Up

Recarrega o saldo automaticamente quando cair abaixo de um limiar definido por você. Útil para 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 é processado com segurança pelo Asaas, que guarda os dados. A Tokia nunca vê nem armazena o número do cartão.
  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$ 20 e R$ 5.000.
    • Cartão: qual cartão usar (caso tenha múltiplos).
  5. Clique Salvar configuração.

Quando a recarga roda

  • A verificação automática roda a cada 1 hora.
  • Cooldown de 30 minutos entre charges do mesmo user, evita cobrar de novo se a confirmação do pagamento 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 para reativar.

Notificações

  • Email "Recarga automática de R$ [valor] 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.