Cómo recibir por API los códigos de verificación telefónica de Gojek

¿Cómo usa Gojek tu número de teléfono?

Gojek nació en Indonesia como un servicio de mototaxis y creció hasta convertirse en una superapp que abarca transporte, reparto de comida, envío de paquetes y pagos; hoy forma parte del mismo grupo que Tokopedia. El número de teléfono es el centro de una cuenta de Gojek: es el identificador de inicio de sesión, un código de un solo uso lo confirma en el registro, y se pide otro cuando alguien inicia sesión en un dispositivo nuevo o cambia de número.

Por eso cualquiera que se integre con Gojek o dé soporte a sus usuarios acaba necesitando un número de teléfono de Gojek para pruebas. Cuando la app ofrece elegir el canal de entrega, elige SMS, porque un número del OTP Gateway recibe mensajes de texto.

Motivos habituales por los que un equipo solicita una verificación por SMS de Gojek para pruebas:

• Una integración con un socio, como un enlace de comercio o de fidelización, que necesita un acceso nuevo a Gojek en una ejecución de staging.
• El personal de soporte que reproduce el problema de inicio de sesión de un cliente en una cuenta limpia que controla.
• Comprobaciones de localización que confirman cómo se ven la pantalla del código y su temporizador de reenvío en bahasa indonesio y en inglés.

¿Por qué importa el país de un número de prueba de Gojek?

El servicio gojek figura en 197 países en OTP Route, pero el adecuado depende de lo que estés comprobando. La mayoría de las cuentas reales de Gojek son indonesias, así que Indonesia (+62) es la opción natural por defecto; los móviles indonesios se escriben 08… en el ámbito local y pasan a +62 8… en E.164 una vez eliminado el cero del prefijo troncal. Los mensajes de verificación en cuentas indonesias suelen llegar en bahasa indonesio.

Otras rutas incluyen Singapur, Malasia, Vietnam, Filipinas, Tailandia, India, Australia, Japón, Reino Unido, Estados Unidos y Brasil. Un número de fuera del sudeste asiático resulta útil cuando quieres ver cómo se comporta el registro para un viajero o para una región no compatible. El artículo sobre enrutamiento por país explica cómo elegir.

¿Cómo es el flujo de la API para el servicio gojek?

Envía las solicitudes a https://otproute.com/api/v1 con una clave Bearer que empiece por or_live_.

1. Lee GET /api/v1/prices?country=id&service=gojek para ver el precio y la disponibilidad en tiempo real de la ruta indonesia.
2. Crea el pedido: POST /api/v1/activations con {"service": "gojek", "country": "id"}. Conserva el id de activación.
3. Introduce el número devuelto en la app de Gojek y solicita el código.
4. Recibe el código desde activation.sms_received en tu webhook, o haz polling a GET /api/v1/activations/{id}.
5. Llama a POST /api/v1/activations/{id}/cancel si abandonas la prueba.

En los webhooks, comprueba la cabecera X-OTPRoute-Signature (t=<unix>,v1=<hex>) calculando HMAC-SHA256 de <t>.<raw body> con el secreto del endpoint, y descarta las marcas de tiempo antiguas. Como una entrega puede reintentarse, haz el handler idempotente: usa el id de activación como clave e ignora las repeticiones. El polling está bien para ejecuciones individuales dentro del límite de 300 solicitudes por minuto. Consulta la documentación para la referencia completa.

¿Puedo recibir un OTP de Gojek desde el panel?

Sí. Elige Gojek como servicio, selecciona el país, confirma el precio mostrado y haz el pedido. Escribe el número en la app, pulsa para enviar el código y observa la tarjeta de la activación; el SMS aparece allí cuando llega. El pedido permanece abierto durante 20 minutos y, si no llega nada o si cancelas, el importe completo vuelve a tu monedero.

¿Por qué podría no llegar el SMS de Gojek?

Hay varias causas comunes:

• Gojek, como muchas apps, puede rechazar números virtuales o pedir comprobaciones adicionales; no se te cobra cuando no llega ningún código.
• Es posible que la app haya enviado el código por un canal distinto del SMS.
• La ruta puede estar ocupada; espera a que termine la ventana y luego reintenta más tarde o prueba con otro país.
• Las solicitudes repetidas en rápida sucesión pueden activar los tiempos de espera propios de la app, así que espacia los intentos en lugar de hacer un bucle.

¿Cuándo encaja mejor un número dedicado?

Un número de un solo uso cubre un código. Si una cuenta de prueba u operaciones de Gojek debe seguir iniciando sesión, un número dedicado con SMS a largo plazo puede ser más adecuado, pero solo se ofrecen en Estados Unidos y Canadá, desde $1.95/month, y solo sirven cuando la cuenta acepta un número estadounidense o canadiense. Compara ambas opciones en números temporales frente a dedicados.

¿Cómo mantener un uso responsable en las pruebas con Gojek?

Cumple las condiciones de Gojek. Mantén una cuenta por persona real o empresa, usa los números solo para probar los flujos de tu propio producto o para operar tus propias cuentas legítimas, y nunca para crear cuentas adicionales ni para reclamar promociones de registro. OTP Route no está afiliado a Gojek, el nombre es una marca registrada de su titular y la Política de Uso Aceptable de OTP Route se aplica a cada pedido.

Preguntas frecuentes

¿Puedo recibir un OTP de Gojek sin una SIM indonesia?

Sí. Pide un número +62 de un solo uso para el servicio gojek en el OTP Gateway y lee el código en el panel o a través de la API.

¿Cuál es el id de servicio de Gojek en la API de OTP Route?

Es gojek; combínalo con un id de país como id para Indonesia.

¿Se acepta siempre un número virtual para Gojek?

No. Gojek puede rechazar algunos números virtuales, y por eso una activación sin código se reembolsa automáticamente.

¿Cuánto tiempo permanece abierta la activación de Gojek?

Veinte minutos. Si no llega ningún SMS en ese tiempo, o si cancelas, el cargo vuelve a tu monedero.

¿Puedo usar el mismo número para iniciar sesión en Gojek más adelante?

No con el OTP Gateway, que cubre un código por número. Para inicios de sesión repetidos, valora un número dedicado de EE. UU. o Canadá si la cuenta lo permite.

¿Cómo evito el procesamiento duplicado de webhooks en los códigos de Gojek?

Verifica la firma, guarda el id de activación e ignora cualquier evento que ya hayas gestionado.

¿Puedo probar sin gastar dinero?

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

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.