Cómo recopilar por programación códigos OTP indonesios +62

¿Qué endpoints llama una integración de la API OTP de Indonesia?

Todo funciona contra https://otproute.com/api/v1 con una clave Bearer con el prefijo or_live_. Crea una en la consola de desarrolladores; una cuenta puede tener hasta 10 claves, lo que facilita separar un ejecutor de CI de un equipo de staging.

1. Obtén GET /api/v1/services y GET /api/v1/countries y guarda ambas listas en caché. Indonesia aparece con el id id.
2. Pide GET /api/v1/prices?country=id&service=<id> para conocer el precio y la disponibilidad actuales del servicio que vas a probar. El inventario se mueve durante el día, así que consúltalo en cada ejecución en lugar de fijarlo en el código.
3. Crea el pedido con POST /api/v1/activations y un cuerpo como {"service": "tokopedia", "country": "id"}. Recibes un id de activación y un número +62.
4. Escribe o inyecta ese número en el campo de teléfono de tu propia app o cuenta de pruebas.
5. Lee el resultado a través de un webhook, o haz polling a GET /api/v1/activations/{id}. Aborta limpiamente con POST /api/v1/activations/{id}/cancel cuando una prueba falle antes del paso del SMS.

Un GET /api/v1/balance rápido antes de que empiece la suite permite que una ejecución falle pronto y no a mitad de camino. Hacer polling a un intervalo razonable cabe sin problema dentro del tope de 300 solicitudes por minuto. Los esquemas completos están en la documentación de la API.

¿Cómo proceso los códigos +62 con un webhook firmado?

El polling sirve para un único desarrollador; las tareas en paralelo van más tranquilas con entrega push. Registra hasta 5 endpoints por cuenta y suscríbete a activation.sms_received, activation.expired y activation.cancelled.

Cada solicitud incluye una cabecera X-OTPRoute-Signature con el formato t=<unix>,v1=<hex>. Reconstruye la cadena firmada como <t>.<raw body>, calcula el HMAC-SHA256 con el secreto del endpoint y compáralo con v1 en tiempo constante. Calcula el hash de los bytes sin procesar antes de cualquier análisis de JSON, y descarta las solicitudes cuya marca de tiempo sea demasiado antigua para que un payload capturado no pueda reproducirse.

Trata los eventos como identificados por el id de la activación y haz el manejador idempotente: una entrega reintentada simplemente debe encontrar el código ya guardado. Nuestro artículo sobre la seguridad de webhooks con HMAC repasa las comprobaciones.

¿Qué servicios pueden recibir SMS OTP de Indonesia en OTP Route?

La instantánea en directo de Indonesia abarca más de 3,000 servicios. Entre las rutas populares están WhatsApp, Tokopedia, Shopee, Lazada, Telegram, Google (Gmail y YouTube), Facebook, Instagram, TikTok, LINE, Discord, Microsoft y Outlook y ChatGPT (OpenAI).

Para los compañeros que nunca tocan la API, el panel hace el mismo trabajo: inicia sesión, elige el servicio, elige Indonesia, comprueba el precio mostrado y haz el pedido. El número +62 aparece en pantalla y el código se muestra a su lado cuando entra el SMS. Cancela desde esa misma vista si la prueba se suspende.

¿Cómo se debe almacenar y normalizar un número +62?

Indonesia usa un prefijo troncal 0, así que a nivel nacional los móviles se escriben como 08 seguido del resto de los dígitos. En E.164 el 0 desaparece: un número escrito localmente como 0812... pasa a ser +62812.... Guarda la forma E.164, normaliza todo lo que escriba un usuario eliminando espacios, guiones y el 0 inicial, y deja que una biblioteca de números de teléfono mantenida juzgue la validez, porque los números de abonado indonesios no comparten todos una misma longitud.

Las plantillas de SMS enviadas a números indonesios suelen estar en bahasa indonesio, aunque algunos servicios envían en inglés. Extrae el código con un patrón de dígitos en lugar de buscar palabras como "kode" o "code", y tu analizador no se verá afectado por el idioma de la plantilla.

¿Por qué los equipos de producto prueban los flujos de registro en Indonesia?

Indonesia es uno de los países más poblados del mundo y su uso de internet es sobre todo móvil, por lo que la verificación del número de teléfono está al principio de muchos flujos de onboarding. Los equipos que se expanden por el Sudeste Asiático quieren ver que sus propias pantallas de registro e inicio de sesión en Indonesia se comportan correctamente con un número +62 real, comprobar que los textos en bahasa indonesio se muestran sin truncarse y confirmar que sus reglas antifraude no bloquean a usuarios locales legítimos.

Los equipos de operaciones regionales y de marketplaces también usan la ruta para verificar cuentas de empresa que gestionan para tiendas indonesias. La página de pruebas de QA explica cómo integrar esto en un plan de regresión.

¿Qué pasa si el código indonesio nunca aparece?

El tiempo de entrega depende del servicio y de la ruta, así que dale margen a la activación antes de decidir que ha fallado. Cuando no llega ningún SMS:

• Deja que se agote la ventana de 20 minutos, o cancela; en ambos casos el importe completo vuelve a tu monedero automáticamente.
• Vuelve a pedir un poco más tarde, o prueba otra ruta de servicio si tu prueba lo permite.
• Confirma que el servicio de destino acepta números virtuales para esta acción. Algunos no, que es exactamente por lo que existe la regla de reembolso.
• Evita volver a pedir en un bucle cerrado. Espacia los intentos para que un trabajo de CI no gaste los reintentos en segundos.

Hay más ideas de diagnóstico en cómo reducir las entregas fallidas de OTP.

¿Hay un número +62 dedicado y cómo se factura?

No. No se ofrece una línea indonesia de largo plazo de autoservicio. Los Números Dedicados son un producto de Estados Unidos y Canadá, desde $1.95/mes. Si tu equipo necesita de verdad una línea +62 duradera, escribe a [email protected]; que se pueda gestionar depende de la normativa local y no se promete.

La facturación del OTP Gateway usa un único monedero prepago en USD sin cuota mensual ni plan que elegir. Recarga el monedero con tarjeta o con las stablecoins USDT/USDC; cada recarga genera una factura en PDF por correo para tus registros financieros. Las cuentas de desarrollo pueden solicitar el modo sandbox, que devuelve números y códigos simulados para pruebas de integración de extremo a extremo sin gastar fondos. Consulta los precios o crea una cuenta.

Preguntas frecuentes

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

Sí. Pide un número +62 en el OTP Gateway para el servicio correspondiente, introdúcelo en tu app y lee el código en el panel o a través de la API.

¿Qué id de país usa la API de OTP Route para Indonesia?

Indonesia es id, así que una consulta de precio queda como GET /api/v1/prices?country=id&service=<id>.

¿Pago si el SMS indonesio nunca llega?

No. Si no entra nada durante la ventana de 20 minutos, o cancelas, el cargo completo vuelve a tu monedero automáticamente.

¿Debo conservar el 0 inicial al guardar un móvil indonesio?

Consérvalo solo para mostrarlo en formato local. Guarda +62 seguido del número nacional sin el 0, que es la forma E.164.

¿Estarán en inglés los textos de verificación indonesios?

No siempre. Muchos llegan en bahasa indonesio, así que analiza el código numérico en lugar de depender de las palabras que lo rodean.

¿Se permiten los números indonesios para cualquier fin?

Solo para un uso legítimo: probar y operar tus propios productos y cuentas dentro de los términos de cada servicio. La Política de Uso Aceptable de OTP Route se aplica a cada pedido.

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.