API de Verificação OTP
para Revendedores
Revenda números de verificação SMS de uso único a partir de $0,10 através de uma REST API. Provisionamento instantâneo, reembolso total em ativações não utilizadas e webhooks assinados — construa sua própria plataforma de OTP usando números reais de operadoras.
Uma API para cada verificação SMS de uso único que você precisar
Caixas de entrada SMS públicas gratuitas são publicamente legíveis e já estão sinalizadas por todas as principais plataformas. Construir seus próprios relacionamentos com operadoras para números de uso único é caro para algo que os clientes usam uma vez e descartam.
A API VRNUM OTP oferece um pool privado, ao vivo, de números de operadoras reais sob demanda. Provisiona um, recebe o código, e o número nunca é mostrado para mais ninguém — com sua margem já aplicada a cada preço que você exibe.
Do pedido ao código verificado
Quatro chamadas cobrem todo o ciclo de vida do OTP.
Verifique o catálogo
GET /otp-catalog para serviços, países e preços ao vivo — aplique sua margem antes de mostrar aos clientes.
Solicitar um número
POST /otp-numbers com um serviço, país e Idempotency-Key. Um número é retornado imediatamente.
Obter o código
GET /otp-numbers/:id verifica ao vivo o SMS, ou aguarde o evento otp.completed no webhook.
Reenviar ou reembolsar
Ainda não tem código? Tente /resend, ou /cancel para um reembolso total instantâneo para sua carteira.
Solicite um número OTP em uma única requisição
clientReference é seu próprio ID opaco — anexe-o para conciliar pedidos com seus registros internos de clientes.
curl -X POST https://vrnum.com/api/v1/otp-numbers \
-H "Authorization: Bearer vrnum_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: otp-5521" \
-d '{
"service": "whatsapp",
"countryCode": "us",
"clientReference": "otp-5521"
}'Um ciclo completo de pedido de OTP
Catálogo, pedido, reenvio, cancelamento/reembolso e webhooks — uma API JSON consistente.
/api/v1/otp-catalog/api/v1/otp-numbers/api/v1/otp-numbers/api/v1/otp-numbers/:id/api/v1/otp-numbers/:id/resend/api/v1/otp-numbers/:id/cancel/api/v1/webhook/api/v1/balanceDocumentação completa de solicitações/respostas e suas chaves ficam no seupainelapós você entrar.
Quem desenvolve na API de verificação OTP
Qualquer produto que precise de um número de telefone real para uma única etapa de verificação.
Plataformas de verificação por SMS
Revenda números OTP para seus próprios clientes sob sua marca, com sua própria margem de lucro em cada serviço.
QA e automação de testes
Crie contas de teste descartáveis em serviços de produção sem usar números de telefone pessoais.
Ferramentas para bots e agências
Provisionamento de números de forma programática para fluxos de trabalho de criação de contas construídos para clientes.
Ferramentas para desenvolvedores
Ofereça 'verificação por SMS' como um recurso em seu próprio aplicativo ou SDK sem precisar possuir infraestrutura de telecomunicações.
Confiável o suficiente para cobrar seus próprios clientes
Chaves de idempotência
Tente novamente com segurança em casos de timeout — a mesma Chave de Idempotência sempre retorna o pedido original, nunca um duplicado.
Webhooks assinados
Eventos otp.completed, number.provisioned e number.provisioning_failed, assinados com X-VRNUM-Signature.
Tentativas automáticas
Falhas na entrega de webhooks são tentadas novamente seguindo uma programação de retentativa (5min, 30min, 2h, 6h, 24h) antes de desistirmos.
Limites de taxa transparentes
60 solicitações/minuto por chave com cabeçalhos X-RateLimit-* em cada resposta.
Cobrança financiada por carteira
Sem faturas ou assinaturas — pedidos e reembolsos são lançados no seu saldo no instante em que acontecem.
Códigos de erro estáveis
Cada erro retorna um código JSON normalizado em que sua integração pode confiar de forma consistente.
Perguntas frequentes
Posso revender números OTP através da API VRNUM?
Sim. Os endpoints otp-catalog e otp-numbers retornam apenas seu preço de revenda. Defina sua própria margem por serviço e país — seus clientes nunca veem o custo interno da VRNUM.
O que acontece se o código OTP nunca chegar?
Chame POST /otp-numbers/:id/cancel em uma ativação ainda aguardando para um reembolso total na sua carteira. Você também pode chamar o endpoint de reenvio primeiro.
Quanto tempo uma ativação OTP permanece válida via API?
Cada ativação permanece ativa por 20 minutos a partir da criação. Cancele antes de expirar para um reembolso total se nenhum código chegar.
Como evitar cobrar um cliente duas vezes em uma tentativa de repetição?
Envie um cabeçalho Idempotency-Key em POST /otp-numbers. Repetir a mesma solicitação com a mesma chave retorna o pedido original em vez de criar um novo.
Posso receber eventos de entrega em tempo real em vez de fazer polling?
Sim. Registre um endpoint de webhook e receba eventos otp.completed assinados no momento em que acontecem, em vez de fazer polling.
Quais serviços são suportados através da API?
Mais de 80 serviços incluindo WhatsApp, Telegram, Google, Instagram, Facebook, Discord e mais. Chame GET /otp-catalog para a lista atual.
Comece a revender números OTP hoje
Crie uma conta gratuita, gere sua chave de API e provision a seu primeiro número OTP em minutos.