API OTP de Catar: webhooks, polling y números de prueba +974

¿Cómo es la secuencia de llamadas de la API OTP de Catar?

Todo cuelga de https://otproute.com/api/v1, con autenticación mediante una clave Bearer que empieza por or_live_. Puedes tener hasta 10 claves, así que da claves distintas a CI, staging y al script de operaciones y revoca una sin tocar las demás. Una activación +974 completa necesita cuatro llamadas como máximo:

1. GET /api/v1/prices?country=qa&service=<id> devuelve el precio en vivo e indica si la ruta está abierta ahora mismo para ese servicio.
2. POST /api/v1/activations con {"service": "<id>", "country": "qa"} reserva un número catarí y devuelve un id de activación.
3. GET /api/v1/activations/{id} es la llamada de polling: muestra en qué estado está el pedido de Catar e incluye el código tras la entrega.
4. POST /api/v1/activations/{id}/cancel termina el pedido antes de tiempo y devuelve el importe a la billetera.

Dos auxiliares completan el cuadro: GET /api/v1/services asocia nombres con ids de servicio, y GET /api/v1/balance permite que un pipeline se detenga antes de quedarse sin saldo. Mantén el tráfico por debajo de 300 solicitudes por minuto y cuenta. La vista general para desarrolladores reúne las páginas de referencia.

¿Cómo debe tratar un handler de webhook los eventos de activación de Catar?

El polling funciona, pero un webhook permite que tu ejecutor de pruebas reaccione en el momento en que ocurre algo. Registra hasta cinco endpoints y suscríbete a activation.sms_received, activation.expired y activation.cancelled; el primero lleva el código y los otros dos indican a tu ejecutor que deje de esperar.

Cada solicitud incluye X-OTPRoute-Signature con la forma t=<unix>,v1=<hex>. Reconstruye la cadena firmada como la marca de tiempo, un punto y el cuerpo bruto de la solicitud, calcula HMAC-SHA256 con el secreto del endpoint y compara en tiempo constante. Rechaza todo lo que tenga una marca de tiempo caducada. Como los reintentos pueden entregar el mismo evento más de una vez, guarda el id de activación e ignora las repeticiones. Para una implementación de referencia, lee captura de OTP mediante webhooks.

¿Qué servicios pueden enviar un código a un número +974?

Catar es una de las rutas más amplias, con más de 1,600 servicios en la última instantánea. Entre las entradas populares están WhatsApp, Google (Gmail & YouTube), Microsoft & Outlook, Telegram, Instagram, Facebook, LinkedIn, Snapchat, TikTok, Uber, Airbnb, ChatGPT (OpenAI), Claude y Discord.

El inventario cambia a lo largo del día, así que toma la instantánea como orientación y la respuesta de la API como la verdad. Algunos servicios rechazan los números virtuales; cuando lo hacen, el pedido simplemente expira y el dinero se devuelve. Cada nombre anterior es marca registrada de su titular, sin que se implique afiliación alguna.

Normalizar números cataríes en los fixtures de prueba

Los números cataríes tienen ocho dígitos después de +974 y ningún prefijo troncal, así que no hay nada que quitar al convertir un número local a formato internacional. Mantén los fixtures en E.164 (+974 más ocho dígitos) y limpia las entradas que los usuarios escriben con 00974, espacios o un cero inicial sobrante arrastrado de las costumbres de otro país.

El árabe es el idioma oficial, mientras que el inglés se usa mucho en los negocios y por una población con una gran proporción de expatriados. Por tanto, los mensajes de verificación llegan en el idioma que el servicio emisor elija para la cuenta, a menudo inglés o árabe. Comprueba que tu lógica de extracción encuentra el código en ambos alfabetos y que una interfaz en árabe mantiene utilizable el campo del OTP en un diseño de derecha a izquierda.

Los equipos prueban la ruta de Catar al lanzar en el CCG, al localizar una app de consumo para hablantes de árabe, al gestionar operaciones de hostelería o logística en Doha, o al verificar una cuenta empresarial regional sin poner el número personal de un empleado. La guía de pruebas en CI muestra cómo integrar estas comprobaciones en ejecuciones automatizadas.

Hacer una comprobación de Catar desde el panel

No toda verificación necesita un script. En el panel, abre el OTP Gateway, selecciona Catar y el servicio, revisa el precio mostrado y confirma. Copia el número +974 en la app, solicita el SMS y el código aparecerá en el pedido. La ventana de 20 minutos cuenta desde el momento en que haces el pedido, y solo pagas si aparece un código.

Códigos que no llegan: una lista de depuración

• ¿Esperaste lo suficiente? Deja que la activación recorra su ventana completa antes de darla por fallida.
• ¿Se aceptan números virtuales? Algunos servicios los bloquean, y los intentos repetidos no lo cambiarán.
• ¿Es sensata la política de reintentos? Espera y reintenta más tarde, o cambia a otra ruta para el mismo servicio. Repetir pedidos en un bucle cerrado malgasta tu límite de solicitudes y rara vez ayuda.
• ¿Está sano el handler? Si falla la comprobación de la firma o el endpoint devuelve un error, consulta GET /api/v1/activations/{id} para ver si el código se entregó mientras tu webhook fallaba.

Una activación que termina sin SMS, por expiración o por cancelación, se reembolsa íntegramente.

¿Existe una línea catarí de largo plazo y cómo se factura el uso?

No existe ningún número de largo plazo de autoservicio para Catar. Los Dedicated Virtual Numbers (tu propia línea con SMS entrantes y salientes, reenvío por webhook y llamadas desde el navegador) se ofrecen solo en Estados Unidos y Canadá, desde $1.95/mes. Para una necesidad específica de Catar, escribe a [email protected]; la normativa local determina qué es posible.

El uso en Catar se carga a una única billetera prepago en USD, y nada se factura mensualmente. Recarga con tarjeta o USDT/USDC, recibe una factura en PDF por cada recarga y pide el modo sandbox en una cuenta de desarrollo si quieres probar la integración con números y códigos simulados. Usa los números +974 solo para tus propios productos y cuentas empresariales legítimas, respeta los términos de cada servicio y cumple la Política de Uso Aceptable de OTP Route.

Preguntas frecuentes

¿Cómo recibo códigos SMS OTP de Catar en una prueba automatizada?

Crea una activación con el país qa, introduce el número devuelto en la app que estás probando y espera el webhook activation.sms_received. OTP Route también admite consultar la activación por polling si tu ejecutor de pruebas no puede aceptar solicitudes entrantes.

¿Puedo usar un número +974 para pruebas sin una SIM catarí?

Sí. El OTP Gateway proporciona un número de verificación de Catar para un código, de modo que puedes probar flujos de registro o de inicio de sesión sin ninguna SIM ni dispositivo local.

¿Cómo compruebo los precios de Catar antes de pedir?

Llama a GET /api/v1/prices?country=qa&service=<id> o mira en el panel. Las tarifas empiezan en $0.20 por código y varían según el servicio.

¿Se me cobran las activaciones de Catar que fallan?

No. Solo se te factura cuando llega un código; las activaciones expiradas o canceladas se reembolsan automáticamente a la billetera.

¿Por qué probar con un número catarí en lugar de uno de un país vecino?

Elige el país que coincida con el mercado real de la cuenta. Si tu producto se lanza en Catar, un número +974 ejercita exactamente el manejo del código de país, el idioma y el OTP routing que verán tus clientes, como se explica en enrutamiento por país para OTP.

¿Puede funcionar una cuenta de desarrollo sin fondos en la billetera?

Sí. Bajo petición, una cuenta de desarrollo puede pasarse a sandbox, que devuelve números y códigos simulados para pruebas de extremo a extremo.

¿Puedo conservar un número catarí para inicios de sesión repetidos?

No en autoservicio, porque las líneas dedicadas se limitan a EE. UU. y Canadá. Escribe a [email protected] si quieres consultar sobre una línea de Catar de largo plazo.

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.