Recibir códigos de verificación +966 por programación para lanzamientos en Arabia Saudita

¿Cómo es una activación +966 individual a través de la API?

Empecemos por las llamadas, ya que la mayoría de quienes leen esta página están integrando una API de verificación por SMS en una batería de pruebas o en una herramienta interna. Todos los endpoints cuelgan de https://otproute.com/api/v1 y esperan una clave Bearer con el prefijo or_live_, creada en la consola de desarrolladores.

1. GET /api/v1/countries y GET /api/v1/services te dan los ids. Arabia Saudita es sa.
2. GET /api/v1/prices?country=sa&service=<id> devuelve la tarifa en vivo para esa combinación; regístrala junto a la ejecución de la prueba.
3. POST /api/v1/activations con {"service": "<id>", "country": "sa"} devuelve un id de activación y un número +966.
4. Tu prueba introduce el número en la aplicación y el código llega como evento o mediante GET /api/v1/activations/{id}.
5. Si la prueba se abandona, POST /api/v1/activations/{id}/cancel la libera y reembolsa el monedero.

GET /api/v1/balance resulta útil como comprobación previa, de modo que un trabajo nocturno falle pronto con un mensaje claro en lugar de a mitad de ejecución. Límites a tener en cuenta: 10 claves y 5 endpoints de webhook por cuenta, 300 solicitudes por minuto.

¿Cómo debe tratar nuestro receptor de webhooks los eventos OTP saudíes?

Registra un endpoint y suscríbete a activation.sms_received, activation.expired y activation.cancelled. Cada solicitud incluye X-OTPRoute-Signature con el formato t=<unix>,v1=<hex>.

• Reconstruye la cadena firmada como <t>.<raw body> y calcula HMAC-SHA256 con el secreto de ese endpoint.
• Compara con v1 mediante una función de tiempo constante y rechaza cualquier solicitud cuya marca de tiempo sea demasiado antigua.
• Trata cada evento como identificado por el id de activación, para que una reentrega no actualice nada dos veces.
• Responde con un 2xx enseguida y deja el trabajo lento para un proceso en segundo plano.

El polling sigue siendo una alternativa válida para ejecutores que no pueden aceptar conexiones entrantes. Nuestros artículos sobre la captura de OTP mediante webhooks y la protección de webhooks OTP con HMAC profundizan en ello.

¿Por qué prueban los equipos de producto con un número +966?

Arabia Saudita es uno de los mayores mercados digitales del Golfo, y los equipos llegan a esta página por motivos prácticos: una fintech que prepara el alta de residentes saudíes, un marketplace que incorpora vendedores del Golfo, un proveedor SaaS cuyo cliente exige una comprobación de inicio de sesión regional, o un equipo de operaciones que gestiona cuentas empresariales para una oficina en Riad o Yeda. En todos los casos alguien tiene que demostrar que el flujo funciona con un número de verificación saudí real, y el enrutamiento OTP a través del gateway evita enviar tarjetas SIM a la región. La página de alta en fintech describe ese escenario con más detalle.

¿Qué servicios pueden recibir códigos en las rutas saudíes?

La instantánea en vivo de Arabia Saudita abarca más de 1,000 servicios. Entre los de uso frecuente están Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail & YouTube), Telegram, Amazon, Microsoft & Outlook, LinkedIn, Discord y Netflix. Snapchat y X tienen audiencias especialmente grandes en el Reino, lo que los convierte en elementos habituales de una lista de comprobación de localización. El inventario cambia durante el día, así que consulta la API en el momento de la ejecución.

¿Cómo doy formato a los números +966 y analizo mensajes en árabe?

A nivel local, los móviles saudíes se escriben con un 0 de prefijo troncal, normalmente como 05 seguido de ocho dígitos. La forma internacional elimina ese cero: +966 5 y los ocho dígitos restantes. Normaliza todo a E.164 en el punto de entrada y quita el cero si un usuario lo escribe después del prefijo del país.

El árabe es la lengua oficial, así que los textos de verificación pueden llegar en árabe, en inglés o en ambos. El árabe se escribe de derecha a izquierda, y algunas plantillas pueden usar dígitos arábigo-índicos en lugar de numerales occidentales. Un analizador que convierta esos dígitos a ASCII antes de comparar, y que registre el UTF-8 sin procesar, evita una clase frustrante de falsos fallos.

¿Hay una vía desde el panel para quien no programa?

Sí. Inicia sesión en OTP Route, abre el OTP Gateway, elige Arabia Saudita y el servicio, revisa el precio y confirma. El número aparece al momento y el código se muestra a su lado cuando llega. Un agente de soporte puede usarlo para reproducir en un par de minutos un problema de registro de un cliente.

¿Qué pasa si el código nunca llega, y qué hay de las líneas de larga duración y la facturación?

Si no llega ningún SMS en 20 minutos, o si cancelas, el importe completo vuelve automáticamente al monedero. Deja que termine la ventana, reintenta más tarde o con otra ruta de servicio, confirma que el servicio acepta números virtuales y evita repetir el pedido en un bucle rápido.

No hay un número saudí de larga duración en autoservicio. Los Números Virtuales Dedicados solo se ofrecen en Estados Unidos y Canadá, desde $1.95/month; para una línea +966 de larga duración, escribe a [email protected], teniendo en cuenta que las normas locales deciden si es posible.

La financiación usa un único monedero prepago en USD, de pago por uso y sin cuota mensual. Las recargas funcionan tanto con tarjeta como con USDT/USDC, y cada una genera una factura en PDF enviada por correo. Una cuenta de desarrollo puede pasarse a sandbox a petición para obtener números y códigos simulados. Consulta la página de precios para ver las tarifas actuales.

Preguntas frecuentes

¿Cómo recibo un SMS OTP de Arabia Saudita a través de una API?

Crea una activación con el país sa y el id de tu servicio, y luego toma el código del webhook activation.sms_received o consultando la activación.

¿Se cobra un número +966 de pruebas si el código falla?

No. Si no llega el código, el importe completo se devuelve al monedero cuando se cierra la ventana de 20 minutos o cuando cancelas.

¿Puedo probar el flujo de registro saudí de mi aplicación sin una SIM local?

Sí. El OTP Gateway emite un número +966 para un código, que introduces en tu aplicación y recuperas desde el panel o la API.

¿Cómo debo guardar un móvil saudí introducido como 05XXXXXXXX?

Quita el cero troncal y guárdalo como +966 5 más los ocho dígitos restantes en formato E.164.

¿Podemos conservar el mismo número saudí para inicios de sesión posteriores?

No con un producto de autoservicio, porque los Números Dedicados de larga duración cubren solo EE. UU. y Canadá. Escribe al equipo si necesitas una línea saudí, sin garantía de que pueda facilitarse.

¿Hay forma de ensayar el flujo saudí antes de gastar dinero real?

Sí. Pide el modo sandbox en una cuenta de desarrollo para recibir números y códigos simulados, webhooks incluidos.

¿Qué uso permite OTP Route?

Probar y operar tus propios productos y cuentas legítimos. Respeta las condiciones de cada servicio; se aplica la Política de Uso Aceptable de OTP Route.

Los nombres de los servicios son marcas registradas de sus respectivos propietarios. OTP Route no está afiliado a ellos. Usa los números de forma lícita y respeta las condiciones de cada servicio y nuestra Política de Uso Aceptable.