Cómo integrar la verificación +993 de Turkmenistán en tu flujo OTP

¿Qué llamadas de la API devuelven un número de verificación de Turkmenistán?

Empieza por los endpoints, porque definen todo lo demás. Autentícate contra https://otproute.com/api/v1 con una clave Bearer de la consola de desarrolladores; las claves llevan el prefijo or_live_ y cada cuenta puede tener hasta 10. El id de país de Turkmenistán es tm.

1. GET /api/v1/services y GET /api/v1/countries te dan el catálogo. Guárdalo en caché, pero actualízalo a diario.
2. GET /api/v1/prices?country=tm&service=<id> indica el precio actual y si la ruta está abierta para ese servicio.
3. POST /api/v1/activations con {"service": "imo", "country": "tm"} reserva un número +993 y devuelve un id de activación.
4. GET /api/v1/activations/{id} devuelve el estado del pedido +993 y, cuando llega el SMS, el código.
5. POST /api/v1/activations/{id}/cancel libera un pedido que tu prueba ya no necesita.
6. GET /api/v1/balance permite que un pipeline se detenga a tiempo cuando los fondos escasean.

El límite de la cuenta es de 300 solicitudes por minuto, compartidas entre todas las claves. La referencia de la API documenta la forma de cada solicitud y respuesta.

¿Una prueba con +993 debe escuchar webhooks o hacer polling?

El polling sirve para un desarrollador que recorre un flujo a mano. En cuanto se ejecutan varios trabajos a la vez, los webhooks son más baratos y reaccionan antes. Una cuenta puede tener 5 endpoints de webhook; dirige uno a tu ejecutor de pruebas de Turkmenistán para activation.sms_received, activation.expired y activation.cancelled.

Trata cada entrega como no confiable hasta que se demuestre lo contrario. Separa la cabecera X-OTPRoute-Signature en t y v1, calcula HMAC-SHA256 sobre t, un punto y el cuerpo crudo exacto con el secreto de tu endpoint, y compara en tiempo constante. Rechaza las marcas de tiempo fuera de una tolerancia corta para impedir reenvíos maliciosos. Guarda los resultados con el id de activación como clave para que una entrega repetida no cambie nada. Nuestro artículo sobre la captura de OTP por webhook muestra un manejador respaldado por una cola, y las pruebas en pipelines de CI tratan los tiempos de espera en los trabajos de compilación.

¿Qué se puede verificar con un número de verificación de Turkmenistán?

La ruta tm lista más de 1,600 servicios. Entre los más solicitados ahora mismo están imo, Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI), Viber, WeChat, Discord y Snapchat. Las apps de mensajería concentran gran parte del tráfico cotidiano en Asia Central, y por eso tienen tanto peso aquí.

Esto es una instantánea, no un contrato. La capacidad de nuestros socios operadores cambia a lo largo del día, así que consulta los precios antes de cada ejecución en lugar de suponer que la lista de ayer sigue vigente.

¿Cómo se formatean y localizan los números +993?

El número significativo nacional de Turkmenistán tiene ocho dígitos, y la mayoría de los rangos móviles empiezan por 6. A nivel nacional se marca un prefijo troncal 8 delante; internacionalmente ese prefijo se elimina y el número queda como +993 seguido de los ocho dígitos.

• Normaliza a E.164 (+9936XXXXXXX) en el borde de tu sistema y guarda solo eso.
• No reutilices validaciones escritas para países vecinos; las longitudes y los prefijos difieren en Asia Central.
• El turcomano es el idioma oficial y se escribe en alfabeto latino con letras como ä, ç, ň, ö, ş, ü, ý y ž. El ruso sigue entendiéndose ampliamente. Por tanto, un SMS de verificación puede llegar en turcomano, ruso o inglés, y tu extractor debe leer los dígitos de cualquier cuerpo en UTF-8.

Los equipos suelen hacer pruebas aquí cuando planean un despliegue en Asia Central, cuando una interfaz en turcomano o ruso necesita QA de localización, o cuando atienden a clientes que viajan entre Asjabad y los mercados vecinos.

¿Se puede pedir un código +993 sin escribir código?

Sí. Después de registrarte con un código por correo o con Google y de recargar la cartera, abre el OTP Gateway, elige un servicio, selecciona Turkmenistán y confirma el precio que se muestra. El número +993 aparece al instante; introdúcelo donde lo pida la app, solicita el SMS y observa la tarjeta de la activación para ver el código. El número sirve para esa única verificación.

¿Por qué podría no llegar un código de Turkmenistán?

• El servicio rechaza números virtuales. Algunos lo hacen. Es una política de su lado, y la regla de reembolso existe precisamente para este caso.
• La ruta está saturada. Inténtalo más tarde o con una activación nueva, que usará otro número.
• La ventana se cortó antes de tiempo. Deja la activación abierta los 20 minutos completos; un pedido caducado se reembolsa automáticamente.
• El bucle de reintentos es demasiado agresivo. Espera entre intentos en lugar de hacer pedidos seguidos.

Estos pasos mantienen sano el OTP routing para todos los que comparten el grupo de números.

¿Existe una línea turcomana de larga duración y cómo funciona la facturación?

No existe un Número Dedicado en autoservicio para Turkmenistán. OTP Route vende líneas de larga duración solo en Estados Unidos y Canadá, desde $1.95/month; las solicitudes para otros países pueden enviarse a [email protected], sin garantía de que la normativa local lo permita.

Todo lo demás funciona desde una única cartera prepago en USD, sin cuota mensual. Paga con tarjeta o con USDT/USDC, recibe una factura en PDF por cada recarga y pide el modo sandbox para una cuenta de desarrollo con el fin de probar la API de verificación por SMS con números simulados. Úsala solo para tus propios productos y cuentas legítimos, dentro de los términos de cada servicio y de nuestra Política de Uso Aceptable.

Preguntas frecuentes

¿Puedo obtener un número +993 para probar el registro de mi app?

Sí. Crea una activación con el id de país tm y el servicio que elijas, y usa el número devuelto en tu propio flujo de registro.

¿Cuánto cuesta un código de verificación de Turkmenistán en OTP Route?

Desde $0.20 por código. El precio en vivo de cada servicio sale del endpoint de precios y también se muestra en el panel.

¿Debo incluir el prefijo 8 al introducir un número turcomano?

No. El 8 solo se usa en la marcación nacional, así que usa +993 y el número nacional de ocho dígitos.

¿Cómo sé que un webhook sobre un código +993 viene realmente de OTP Route?

Verifica la firma HMAC-SHA256 de la cabecera X-OTPRoute-Signature contra el cuerpo crudo y rechaza las marcas de tiempo antiguas.

¿El reembolso es automático si no llega ningún SMS al número de Turkmenistán?

Sí. Cuando vence la ventana de 20 minutos o cancelas, el cargo completo vuelve a tu cartera.

¿Puedo conservar un número de Turkmenistán para inicios de sesión repetidos?

No en autoservicio. Los números de larga duración se ofrecen solo para EE. UU. y Canadá; escribe a soporte si tienes un requisito especial.

¿En qué idioma llegarán los mensajes OTP turcomanos?

Depende de la app; son posibles el turcomano, el ruso y el inglés, así que analiza dígitos en lugar de palabras.

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.