API de verificación OTP
para revendedores
Revende números de verificación por SMS de un solo uso desde $0,10 a través de una API REST. Aprovisionamiento instantáneo, reembolso completo de activaciones no utilizadas y webhooks firmados: cree su propia plataforma OTP sobre números reales de operadores.
Una API para cada verificación por SMS única que necesites
Las bandejas de entrada de SMS públicas gratuitas son de lectura pública y ya están marcadas por todas las plataformas principales. Crear sus propias relaciones con el operador para números de un solo uso es costoso de configurar para algo que los clientes usan una vez y descartan.
La API VRNUM OTP le ofrece un grupo privado y en vivo de números de operadores reales a pedido. Proporcione uno, reciba el código y el número nunca se mostrará a nadie más, con su margen de beneficio ya aplicado a cada precio que muestre.
Del pedido al código verificado
Cuatro llamadas cubren todo el ciclo de vida de la OTP.
Consulta el catálogo
OBTÉN /otp-catalog para servicios, países y precios en vivo: aplica tu margen de beneficio antes de mostrárselo a los clientes.
Ordenar un número
POST /otp-numbers con un servicio, país y clave de idempotencia. Un número regresa inmediatamente.
Obtener el código
OBTÉN /otp-numbers/:id live-checks para el SMS o espera el evento de webhook otp.completed.
Reenviar o reembolsar
¿Aún no tienes código? Pruebe /reenviar o /cancelar para obtener un reembolso completo instantáneo en su billetera.
Solicite un número OTP en una sola solicitud
clientReference es su propia identificación opaca: adjúntela para conciliar los pedidos con sus 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"
}'Un ciclo de vida completo de pedidos OTP
Catálogo, pedidos, reenvío, cancelación/reembolso y webhooks: una API JSON coherente.
/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/balanceLos documentos completos de solicitud/respuesta y sus claves se encuentran en sutablerodespués de iniciar sesión.
¿Quién se basa en la API de verificación OTP?
Cualquier producto que necesite un número de teléfono real para un único paso de verificación.
Plataformas de verificación por SMS
Revende números OTP a tus propios clientes bajo tu marca, con tu propio margen de beneficio en cada servicio.
Control de calidad y automatización de pruebas
Cree cuentas de prueba desechables en servicios de producción sin quemar números de teléfono personales.
Herramientas de bot y agencia
Proporcione números mediante programación para flujos de trabajo de creación de cuentas creados para clientes.
Herramientas de desarrollador
Ofrezca 'verificar con SMS' como una función en su propia aplicación o SDK sin poseer una infraestructura de telecomunicaciones.
Lo suficientemente confiable como para facturar a sus propios clientes en
Claves de idempotencia
Vuelva a intentarlo de forma segura en los tiempos de espera: la misma clave de idempotencia siempre devuelve el orden original, nunca un duplicado.
Webhooks firmados
Eventos otp.completed, number.provisioned y number.provisioning_failed, firmados con X-VRNUM-Signature.
Reintentos automáticos
Las entregas fallidas de webhook se reintentan en un cronograma de espera (5 min, 30 min, 2 h, 6 h, 24 h) antes de darnos por vencidos.
Límites de tarifas transparentes
60 solicitudes/minuto por clave con encabezados X-RateLimit-* en cada respuesta.
Facturación financiada con billetera
Sin facturas ni suscripciones: los pedidos y reembolsos se contabilizan en su saldo en el instante en que se realizan.
Códigos de error estables
Cada error devuelve un código JSON normalizado que su integración puede activar de manera confiable.
Preguntas frecuentes
¿Puedo revender números OTP a través de la API VRNUM?
Sí. Los puntos finales otp-catalog y otp-numbers devuelven únicamente su precio de reventa. Establezca su propio margen por servicio y país: sus clientes nunca ven el costo interno de VRNUM.
¿Qué pasa si el código OTP nunca llega?
Llame a POST /otp-numbers/:id/cancel en una activación aún en espera para obtener un reembolso completo en su billetera. También puede llamar primero al punto final de reenvío.
¿Cuánto tiempo permanece válida una activación OTP a través de la API?
Cada activación permanece activa durante 20 minutos desde su creación. Cancele antes de que caduque para obtener un reembolso completo si no llega el código.
¿Cómo evito cobrarle doble a un cliente al reintentar?
Envíe un encabezado Idempotency-Key en POST /otp-numbers. Al volver a intentar la misma solicitud con la misma clave, se devuelve el pedido original en lugar de crear uno nuevo.
¿Puedo obtener eventos de entrega en tiempo real en lugar de realizar encuestas?
Sí. Registre un punto final de webhook y reciba eventos otp.completed firmados en el momento en que suceden, en lugar de realizar una encuesta.
¿Qué servicios son compatibles a través de la API?
Más de 80 servicios, incluidos WhatsApp, Telegram, Google, Instagram, Facebook, Discord y más. Llame a GET /otp-catalog para obtener la lista en vivo.
Comience a revender números OTP hoy
Cree una cuenta gratuita, genere su clave API y proporcione su primer número OTP en minutos.