Español
Cómo integrar los códigos de verificación +7 de Kazajistán en tu suite de pruebas
Sí, OTP Route puede recibir códigos de verificación de Kazajistán (+7) en números de un solo uso del OTP Gateway, entregados a tus sistemas mediante polling REST o un webhook firmado, o mostrados en el panel. Los códigos cuestan desde $0.20 por código, con el precio en vivo devuelto por la API, y solo pagas cuando el SMS llega dentro de la ventana de activación de 20 minutos.
¿Qué endpoints toca una ejecución OTP de Kazajistán?
Un ciclo completo son cinco o seis solicitudes a https://otproute.com/api/v1, firmadas con una clave Bearer que empieza por or_live_. El id de país de Kazajistán es kz, y una cuenta puede tener hasta 10 claves, de modo que CI, staging y el portátil de un desarrollador pueden tener la suya.
GET /api/v1/balanceal principio del trabajo, para que un monedero vacío haga fallar la ejecución pronto.GET /api/v1/prices?country=kz&service=telegrampara leer el precio y la disponibilidad actuales de esa combinación.POST /api/v1/activationscon{"service": "telegram", "country": "kz"}, que devuelve un id de activación y un número +7.GET /api/v1/activations/{id}si haces polling, o nada en absoluto si confías en los webhooks.POST /api/v1/activations/{id}/cancelcuando una prueba termina antes de necesitar el código.
El límite es de 300 solicitudes por minuto por cuenta, lo que deja margen para trabajos en paralelo que hacen polling cada pocos segundos. Si es tu primera integración, empieza por la guía de integración de la API.
¿Cómo consumo los códigos +7 por webhook en lugar de polling?
Registra un endpoint en la consola para desarrolladores (cinco por cuenta) y suscríbete a activation.sms_received, activation.expired y activation.cancelled. Cada POST lleva X-OTPRoute-Signature: t=<unix>,v1=<hex>.
Reconstruye la firma como HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint y compara en tiempo constante. Usa los bytes en bruto tal como llegan, porque un JSON reserializado produce un resumen distinto, y rechaza las marcas de tiempo fuera de una tolerancia corta para evitar repeticiones. Como una entrega puede reintentarse, haz un upsert por el id de activación para que la segunda copia no cambie nada. Hay un recorrido paso a paso en captura de OTP mediante webhooks.
¿Qué apps pueden enviar códigos a un número kazajo?
La ruta kz lista más de 1,700 servicios. Entre los populares de la última instantánea están Telegram, WhatsApp, Google (Gmail y YouTube), Instagram, TikTok, Facebook, Viber, Discord, Microsoft y Outlook, LinkedIn, Uber, AliExpress y Amazon.
No congeles esa lista en el código. Las rutas cambian a lo largo del día, así que un script debe consultar GET /api/v1/prices antes de cada pedido y elegir un id de servicio alternativo cuando una combinación no esté disponible.
¿Por qué el prefijo +7 requiere cuidado en una base de datos de teléfonos?
Kazajistán comparte el código de país 7 con Rusia. Ambos usan números nacionales de diez dígitos, y los rangos móviles kazajos suelen empezar por 7 después del código de país, de modo que un número como +7 7xx xxx xx xx es kazajo mientras que muchos móviles rusos empiezan por 9. Nunca deduzcas el país solo por el prefijo; resuélvelo a partir del rango del número con una librería telefónica mantenida, o conserva un campo de país explícito.
A nivel nacional, la gente marca un 8 troncal delante de los diez dígitos. Elimínalo al recibir la entrada y guarda la forma E.164, +7 seguido del número nacional. El kazajo es la lengua del Estado y el ruso también se usa ampliamente de forma oficial, así que los textos de verificación pueden llegar en ruso, kazajo o inglés, normalmente en cirílico. Asegúrate de que tu analizador de SMS y tus registros manejen UTF-8 y extraigan los dígitos en lugar de la redacción.
Los equipos hacen pruebas aquí cuando lanzan en Asia Central, comprueban la localización bilingüe o dan soporte a personal de operaciones regionales.
¿Hay una vía por el panel para equipos que no programan?
Sí. Después de registrarte con un código por correo o con Google, recarga el monedero, elige Kazajistán y el servicio, confirma el precio que se muestra y haz el pedido. El número +7 y, más tarde, el código aparecen en la tarjeta de la activación. Los responsables de producto y los testers de localización la usan para comprobaciones puntuales mientras el pipeline se encarga del volumen.
¿Se puede conservar un número kazajo para inicios de sesión repetidos?
No existe una opción autogestionada para eso. Los números del OTP Gateway sirven para un único código, y los Números Dedicados de largo plazo solo se venden para Estados Unidos y Canadá, desde $1.95/mes, con SMS entrantes y salientes además de llamadas desde el navegador. Si necesitas una línea kazaja de larga duración, escribe a [email protected]; que se pueda gestionar o no depende de las normas locales y no está asegurado. Para cuentas de staging que deben volver a iniciar sesión, una línea de EE. UU. o Canadá suele ser la respuesta práctica cuando el servicio la acepta.
¿Qué pasa cuando un código no llega en 20 minutos?
La activación caduca, el webhook dispara activation.expired y el importe completo vuelve al monedero sin que tengas que hacer nada. Después, diagnostica antes de reintentar:
- ¿Se envió el número con
+7, y no con el 8 nacional? - ¿El servicio rechaza los números virtuales? Algunos lo hacen, y por eso OTP Route reembolsa las activaciones sin usar.
- Reintenta más tarde o por otra ruta en lugar de repetir al instante; un breve retardo progresivo mantiene legibles tus registros.
La velocidad de entrega depende del servicio y de la ruta, así que evita tiempos de espera muy ajustados en las pruebas.
¿Cómo se factura la cuenta?
Un único monedero prepago en USD, pago por uso, sin suscripción ni niveles de plan. Recarga con tarjeta o con las stablecoins USDT o USDC; cada recarga y cada compra de número genera una factura en PDF por correo. Las cuentas de desarrollo pueden pasar a sandbox si lo solicitas, lo que devuelve números y códigos simulados para pruebas de extremo a extremo. Usa el servicio para tus propios productos legítimos, respeta los términos de cada app y la Política de Uso Aceptable, y consulta los precios para ver las tarifas actuales.
Preguntas frecuentes
¿Cómo distingo un número +7 de Kazajistán de uno ruso?
Mira el rango del número, no solo el código de país. Los móviles kazajos suelen empezar por 7 después de +7; una librería de números telefónicos mantenida o un campo de país explícito evita errores.
¿Cuál es el id de país de Kazajistán en la API de OTP Route?
Usa kz en el cuerpo de la activación y en el parámetro country del endpoint de precios.
¿Puedo probar el registro kazajo de mi app sin una SIM local?
Sí. Pide un número +7 de Kazajistán en el OTP Gateway, introdúcelo en tu propio flujo y recoge el código por webhook, polling o el panel.
¿Se me cobrará si el código de Telegram nunca llega?
No. Si no llega ningún SMS dentro de la ventana de 20 minutos, o tras una cancelación, el importe vuelve automáticamente a tu monedero.
¿Los textos de verificación de Kazajistán vienen en ruso o en kazajo?
Puede ser cualquiera de los dos, y algunos servicios usan inglés. Analiza el código numérico y asegúrate de que tu stack maneje texto en cirílico.
¿Hay una cuota mensual por la ruta de Kazajistán?
No. OTP Route es de pago por uso desde un monedero prepago en USD recargado con tarjeta, USDT o USDC.
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.