Saldo para revendedores: como funciona o saldo usado pela API
A API de revenda usa o mesmo saldo da sua conta no Flash SMS. Não existe uma carteira separada: cada número comprado pela API é descontado desse saldo na hora, pelo preço de revendedor, e cada estorno volta para ele.
- Painel e API compartilham o mesmo saldo da conta.
- A recarga é feita no painel, por Pix, cartão ou cripto.
- getBalance mostra o saldo atual, no formato ACCESS_BALANCE:valor.
- Sem SMS, o valor volta sozinho; sem saldo, a compra responde NO_BALANCE.
Como o dinheiro entra e sai
Você recarrega a conta pelo painel. O valor confirmado vira saldo de uso na plataforma. A cada getNumber que dá certo, o custo daquele número sai do saldo na hora. Se não sair número (NO_NUMBERS), nada é cobrado.
Quando a ativação termina sem SMS, seja porque você cancelou com status=8 a partir de 2 minutos, seja porque os 20 minutos passaram, o valor volta para o mesmo saldo. Se o SMS chegou, a compra está concluída e não há estorno.
Saldo da conta e saldo dos seus clientes
O Flash SMS só enxerga o seu saldo. O saldo de cada cliente da sua revenda existe no seu sistema e é controlado por você: quanto ele pagou, quanto gastou e quanto recebeu de volta. Mantenha os dois conciliados. Uma conferência diária entre a soma das ativações do dia e a variação do getBalance mostra rapidamente qualquer diferença.
Para não ficar sem saldo
- Consulte getBalance de tempos em tempos e crie um alerta abaixo de um valor mínimo definido por você.
- Bloqueie novas vendas no seu sistema antes de chegar a zero, para o cliente não pagar e receber erro.
- Trate NO_BALANCE com uma mensagem amigável, como serviço temporariamente indisponível.
- Recarregue em valores que você pretende usar: pelos termos, o saldo não é reembolsável em dinheiro.
O que os termos dizem sobre o saldo
O saldo depositado vira crédito para usar na plataforma. Ele não é devolvido em dinheiro, por Pix, estorno no cartão ou cripto, e não pode ser transferido para outra conta. Bônus de recarga e créditos de cupom seguem a mesma regra. Contestar no banco ou no cartão uma recarga já creditada pode levar ao débito do valor e à suspensão da conta.
Dúvidas
Perguntas frequentes
Posso ter um saldo só para a API?
Não há saldo separado: painel e API usam o mesmo saldo. Para separar o que é da revenda, use os registros do seu sistema, com o id e o custo de cada ativação.
As comissões de afiliado viram saldo da API?
Não. As comissões do programa de indicação são separadas do saldo de recarga e podem ser sacadas via Pix, conforme as regras da área de afiliados.
Em que moeda fica o saldo?
Em reais. getBalance devolve o valor em R$, e getPrices mostra o custo de cada número também em reais.
Onde vejo as recargas que fiz?
Na página Financeiro do painel, no Histórico de recargas, com data, forma de pagamento, valor e status.
API e integrações
Continue lendo
Número virtual para agências de marketing: como organizar as contas dos clientes
Verificação sem o chip da equipe, contas em nome do cliente e acesso documentado.
Google Play Console: como verificar o telefone da conta de desenvolvedor
O número de contato do desenvolvedor é confirmado por código e precisa continuar seu.
API de revenda de números virtuais: como começar a revender
Padrão sms-activate, preços em reais e saldo por Pix.
API de SMS para desenvolvedores: receba códigos por HTTP
Compre números e leia o SMS com chamadas HTTP simples.
Como integrar a API de números virtuais no seu sistema
O fluxo completo, do pedido do número ao código na tela.
Para que serve uma API de números virtuais
Revenda, testes, bots e painéis internos, e o que é proibido.
Receba seu primeiro código hoje
Cadastro em menos de um minuto, recarga por Pix, cartão ou cripto e o SMS no painel. Se não chegar, o valor volta.
Criar conta grátis