Chave de API, limites e erros
Tudo o que quem programa precisa no primeiro dia com a API, em uma página.
Como consigo uma chave de API do SMS Nitro?
Faça uma recarga, abra a seção API do painel e crie uma chave. As chaves podem ser trocadas a qualquer momento; a antiga para de funcionar na hora. Use como token Bearer na API REST ou como parâmetro api_key no endpoint compatível com SMS-Activate.
Limites
- Compra: até 500 compras por minuto por conta, somando REST e handler_api; no REST vale também o teto de 500 por minuto por IP.
- Reenvio de SMS: até 30 requisições por minuto por IP. Consultar um pedido a cada poucos segundos é normal.
- Cada conta tem uma chave ativa; gerar outra no painel revoga a anterior.
Respostas comuns
- NO_NUMBERS: nenhum número retornado para esse par serviço × país nessa chamada; tente de novo ou outro país.
- NO_BALANCE: recarregue; o valor congelado dos números ativos conta contra o saldo.
- BAD_KEY: a chave foi trocada ou está malformada.
- STATUS_WAIT_CODE / STATUS_OK: esperando o SMS / SMS entregue (endpoint compatível).
SMS Nitro em resumo
| Cobrança | Só paga se o código chegar. Se nenhum SMS chegar antes de o número vencer, o valor congelado volta inteiro para o saldo, automaticamente. |
|---|---|
| Número reservado por | Até 20 minutos por ativação. Aluguel de 24 horas a 30 dias com SMS ilimitados. |
| Pagamento | Pix (Mercado Pago, sem taxa, para contas brasileiras), cartão pela Stripe (Visa, Mastercard, Amex, Apple Pay, Google Pay, taxa de 10%) ou cripto (USDC ou SOL na Solana, sem taxa). Recarga mínima: R$ 15 no Pix ou US$ 5 no cartão e na cripto. |
| Assinatura | Nenhuma. Paga por verificação; o saldo não vence. |
| Países | 180+ países, incluindo Brasil, Estados Unidos, Portugal, Argentina, Reino Unido, Índia, Alemanha, Indonésia e Filipinas. |
| Apps | 700+ apps e sites: WhatsApp, Telegram, Google, Instagram, TikTok, iFood, Mercado Livre, Nubank, 99, PicPay, Discord, ChatGPT e mais. |
| Desenvolvedores | API REST e endpoint compatível com SMS-Activate. Chave liberada depois da primeira recarga. Sem sobretaxa. |
| Suporte | Chamados pelo painel e e-mail, respondidos por gente, em português. |
| Preço | A partir de US$ 0,02 por código de verificação, conforme o app e o país. |
Perguntas frequentes
Tem webhook?
Para SMS, não. Consulte o status do pedido (a cada poucos segundos, dentro do limite de requisições) e leia o texto do SMS assim que chegar.