Cómo recibir códigos de verificación indios (+91) a través de una API

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

Todo el flujo son unas pocas solicitudes contra https://otproute.com/api/v1, autenticadas con una clave Bearer que empieza por or_live_. Las claves salen de la consola de desarrolladores, hasta 10 por cuenta, así que cada entorno puede tener la suya.

1. Llama una vez a GET /api/v1/countries y guarda el resultado en caché. El id de país de India es in.
2. Llama a GET /api/v1/prices?country=in&service=<id> para el servicio que estás probando. Devuelve el precio y la disponibilidad en directo, así que léelo en cada ejecución.
3. Haz el pedido con POST /api/v1/activations y un cuerpo JSON como {"service": "telegram", "country": "in"}. La respuesta te da un id de activación y un número +91.
4. Introduce ese número en la pantalla de registro o inicio de sesión de tu propia app.
5. Recoge el código por webhook o haciendo polling a GET /api/v1/activations/{id}. Si la prueba termina antes de tiempo, llama a POST /api/v1/activations/{id}/cancel.

Comprueba GET /api/v1/balance al comienzo de una suite para que una ejecución falle rápido. La API permite 300 solicitudes por minuto, de sobra para hacer polling cada pocos segundos. Los detalles de solicitud y respuesta están en la documentación de la API.

¿Cómo debe construirse un manejador de webhooks para códigos +91?

Un webhook firmado escala mejor que el polling cuando las tareas se ejecutan en paralelo. Registra un endpoint en la consola de desarrolladores (hasta 5 por cuenta) y escucha activation.sms_received, activation.expired y activation.cancelled.

Cada entrega lleva una cabecera X-OTPRoute-Signature con el formato t=<unix>,v1=<hex>. Para comprobarla, calcula el HMAC-SHA256 de la cadena <t>.<raw body> con el secreto de ese endpoint y compara el resultado con v1 en tiempo constante. Hay dos detalles que hacen tropezar a la gente:

• Calcula el hash de los bytes sin procesar de la solicitud, nunca de un objeto JSON reserializado; el orden de las claves y los espacios cambian el digest.
• Rechaza las marcas de tiempo con más de unos minutos de antigüedad para que una solicitud capturada no pueda reproducirse.

Basa tus escrituras en el id de la activación para que una entrega duplicada no tenga efecto, y confirma con un 2xx antes de hacer trabajo lento. Nuestro artículo sobre cómo proteger los webhooks de OTP con HMAC repasa el paso de comparación línea a línea.

¿Qué servicios pueden enviar códigos a números indios?

La ruta de India lista actualmente más de 2,300 servicios. Entre las entradas populares de la instantánea en directo están WhatsApp, Telegram, Google (Gmail y YouTube), Instagram, Facebook, X (Twitter), ChatGPT (OpenAI), Microsoft y Outlook, Amazon, LinkedIn, Discord, Uber y Snapchat.

La disponibilidad cambia a lo largo del día, y por eso la API la informa en directo. Si tu matriz de pruebas depende de un servicio, consulta los precios de in antes de la ejecución y omítelo limpiamente cuando esa ruta esté cerrada. Usa estas rutas solo para tus propios productos y cuentas, respeta los términos de cada servicio y ten en cuenta que se aplica la Política de Uso Aceptable de OTP Route.

¿Pueden las personas no desarrolladoras pedir un número de verificación de India desde el panel?

Sí. El personal de operaciones y los gestores de cuentas de agencias pueden prescindir de la API:

1. Crea una cuenta con tu correo y un código de 6 dígitos enviado por correo, o con el inicio de sesión de Google, y luego activa la autenticación en dos pasos TOTP.
2. Recarga el monedero.
3. Elige India y el servicio, comprueba el precio en pantalla y haz el pedido.
4. Escribe el número +91 en la app que estás configurando; el código aparece en la página de la activación cuando llega el SMS.

El panel y la API comparten una misma ventana, una misma regla de reembolso y un mismo monedero.

¿Qué debo hacer cuando no llega ningún código en 20 minutos?

Cada activación permanece abierta 20 minutos. Solo pagas si el SMS llega: cuando la ventana se cierra vacía, o cancelas antes, el importe completo vuelve a tu monedero automáticamente y tu webhook recibe activation.expired o activation.cancelled.

Si falta un código:

• Deja que la ventana transcurra antes de reaccionar; un servicio puede simplemente tardar más de lo habitual en enviar.
• Confirma que el servicio acepta números virtuales. Algunas plataformas los rechazan, lo cual es una política suya y no un fallo de entrega.
• Inténtalo de nuevo más tarde, o prueba con otra ruta de servicio.
• No vuelvas a pedir nunca en un bucle cerrado. Espacia los intentos para no gastar esfuerzo en una ruta que está rechazando números.

Hay un tratamiento más largo de la estrategia de reintentos en cómo reducir las entregas fallidas de OTP.

¿Cómo deben almacenarse y normalizarse los números de teléfono indios?

Los números móviles indios tienen diez dígitos y, en la práctica, empiezan por 6, 7, 8 o 9. Dentro de India, la gente suele escribirlos con un 0 troncal inicial, o separados en cinco y cinco con un espacio. El formato internacional elimina ese 0 y añade el código de país, dando +91 seguido de los diez dígitos.

Guarda solo la forma E.164: +91 más diez dígitos, sin espacios, guiones ni cero. Normaliza la entrada en el borde eliminando el formato, un 0 inicial o un 91 suelto escrito sin el signo más. Eso evita usuarios duplicados que solo se diferencian por el formato.

La mayoría de los SMS de verificación en India llegan en inglés y proceden de un identificador de remitente alfanumérico y no de un número de teléfono. Algunas apps envían en hindi u otro idioma regional, así que prueba también cualquier analizador de códigos con escrituras no latinas.

¿Por qué los equipos de producto necesitan un número +91 para pruebas?

India es un mercado de lanzamiento habitual para apps de consumo, onboarding fintech y marketplaces, y sus usuarios esperan un paso por SMS en el registro. Los equipos usan rutas +91 para ensayar un lanzamiento, para hacer QA de localización en interfaces en hindi, tamil, telugu, bengalí, maratí y otros idiomas, para apoyar al personal de operaciones regional y para comprobar los flujos que usan los clientes de la diáspora india en el extranjero que aún inician sesión con un número de su país. Un buen enrutamiento OTP aquí consiste en elegir la ruta de servicio que coincida con el recorrido real del usuario y conectarla a las mismas llamadas de la API de verificación por SMS que usan tus otros mercados.

¿Existe una línea india de largo plazo y cómo funciona la facturación?

No. Los números dedicados son un producto de EE. UU. y Canadá, desde $1.95/mes, y no puedes comprar una línea india de largo plazo desde el panel. Si necesitas una, escribe a [email protected]; la disponibilidad depende de la normativa local y no está garantizada.

La facturación funciona con un único monedero prepago en USD sin cuota mensual ni plan que elegir. Recarga con tarjeta o con las stablecoins USDT/USDC, y cada recarga llega con una factura en PDF por correo. Para el trabajo de integración, pide a soporte que pase una cuenta de desarrollo a sandbox: devuelve números y códigos simulados, para que puedas probar tu manejador de webhooks de extremo a extremo sin gastar fondos del monedero.

Preguntas frecuentes

¿Puedo probar el flujo de registro indio de mi app sin una SIM local?

Sí. Pide un número +91 en el OTP Gateway, introdúcelo en tu pantalla de registro y lee el código en el panel, en la API o en tu webhook.

¿Cuál es el id de país de India en la API de OTP Route?

Es in. Pásalo como país en GET /api/v1/prices y en el cuerpo de POST /api/v1/activations.

¿Cuánto cuesta recibir un SMS OTP de India?

Los códigos empiezan en $0.20 por código y el precio exacto depende del servicio. Lo ves antes de pedir, y una activación que no recibe código se reembolsa a tu monedero.

¿Puedo reutilizar el mismo número +91 para iniciar sesión de nuevo el mes que viene?

No. Un número del gateway cubre un solo código de verificación. Las cuentas que necesitan inicios de sesión repetidos corresponden a una línea dedicada, y esas existen solo en EE. UU. y Canadá.

¿Hay un sandbox para desarrollar la integración con India?

Sí, bajo petición. Soporte puede pasar una cuenta de desarrollo a sandbox, donde números y códigos simulados circulan por tu código sin tocar el monedero.

¿Puede nuestro equipo de finanzas pagar con stablecoins?

Sí. El monedero admite pagos con tarjeta además de USDT y USDC, y cada recarga genera una factura en PDF por correo.

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.