Cómo recibir OTP de Tokopedia en un número enrutado para tus cuentas de prueba y de operaciones

¿Dónde pide Tokopedia un número de teléfono?

Tokopedia es uno de los mayores marketplaces en línea de Indonesia y, como la mayoría de las apps de comercio indonesias, trata el número de teléfono como una parte central de la cuenta. Normalmente se pide un número de teléfono en el registro, se usa para códigos de un solo uso al iniciar sesión en un dispositivo nuevo y se vuelve a comprobar antes de cambios sensibles, como editar los datos de cobro o cambiar el propio número. Las cuentas de vendedor pasan por pasos de confirmación similares.

La app puede ofrecer más de un canal para los códigos; OTP Route captura la ruta por SMS, así que elige SMS cuando la app lo pregunte. Los mensajes suelen llegar en indonesio.

Entre los motivos legítimos para recibir un OTP de Tokopedia en un número enrutado están el QA de una herramienta para vendedores o de una integración de tienda que construyes, las agencias que operan cuentas de comerciantes en nombre de clientes y los equipos de operaciones que quieren mantener un acceso compartido a la tienda fuera de la SIM personal de un empleado. La página de la solución para marketplaces cubre estas configuraciones.

¿De qué país debe ser el número de Tokopedia?

La instantánea en vivo muestra Tokopedia en 197 países. Haz coincidir el número con el mercado real de la cuenta: un número de Indonesia (+62) encaja con la cuenta típica de vendedor o comprador indonesia, mientras que un número de otro lugar es útil para comprobar cómo gestiona tu propio producto la entrada de teléfonos internacionales.

Otros países de la lista son Malasia, Singapur, Brunéi, Filipinas, Tailandia, Vietnam, India, Australia, Japón, Corea del Sur, Hong Kong, Taiwán, Reino Unido, Países Bajos y Estados Unidos. Un caso de prueba debe indicar el país que espera, de modo que un fallo apunte al flujo y no a una ruta que no coincide.

¿Cómo funciona el flujo de la API de códigos de verificación de Tokopedia?

Autentícate en https://otproute.com/api/v1 con una clave Bearer con prefijo or_live_. El id del servicio es tokopedia, y el id de país de Indonesia es id.

1. Consulta GET /api/v1/prices?country=id&service=tokopedia para ver el precio y la disponibilidad en vivo.
2. Haz el pedido con POST /api/v1/activations y el cuerpo {"service": "tokopedia", "country": "id"}.
3. Introduce el número recibido en la pantalla de registro o de inicio de sesión que estás probando y solicita el código por SMS.
4. Lee el resultado desde tu webhook, o haz polling a GET /api/v1/activations/{id} hasta que aparezca el código.
5. Llama a POST /api/v1/activations/{id}/cancel si la prueba se aborta, para que los fondos vuelvan de inmediato.

El límite de la cuenta de 300 solicitudes por minuto es más que suficiente para el polling. Las formas completas de solicitud y respuesta están en la documentación de la API.

¿Cómo debe escribirse un manejador de webhooks para Tokopedia?

Apunta uno de tus cinco endpoints de webhook a una ruta que escuche activation.sms_received, activation.expired y activation.cancelled de los pedidos de Tokopedia. Cada entrega incluye X-OTPRoute-Signature: t=<unix>,v1=<hex>; calcula el HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint, compara en tiempo constante y rechaza las marcas de tiempo caducadas.

Haz el manejador idempotente usando el id de la activación como clave, porque una entrega reintentada no debe completar la misma prueba dos veces. Si prefieres no exponer un endpoint, el polling funciona igual de bien para un único script. La guía de captura por webhook incluye un diseño de ejemplo.

¿Puede el panel gestionar un código de Tokopedia sin escribir código?

Sí. Abre el OTP Gateway, elige Tokopedia, selecciona un país y confirma el precio en pantalla. Copia el número en la app de Tokopedia, selecciona SMS como canal, y el código aparece junto a la activación una vez recibido. Un responsable de operaciones de comercio puede hacerlo mientras los desarrolladores usan la API desde el mismo monedero.

¿Por qué puede no llegar un OTP de Tokopedia?

Varias cosas pueden impedir que llegue un código: la app puede rechazar números virtuales en algunos flujos, puede limitar las solicitudes repetidas al mismo número, o el código puede haberse enviado por un canal distinto del SMS. Las rutas también varían a lo largo del día.

Cada activación dura 20 minutos y solo pagas cuando el código llega. Si no llega nada, el importe vuelve a tu monedero automáticamente. Deja que termine la ventana, reintenta más tarde o desde otra ruta de país que encaje con la cuenta, y evita volver a pedir en un bucle rápido. Nuestra guía sobre entregas fallidas enumera más comprobaciones.

¿Debería una cuenta de tienda de Tokopedia usar un número dedicado?

Una activación de un solo uso sirve para una prueba de registro nuevo. Una cuenta de tienda que debe iniciar sesión de nuevo el mes que viene necesita un número que siga bajo tu control; de lo contrario, un futuro código de inicio de sesión puede no tener adónde llegar. Los números dedicados cubren ese caso en Estados Unidos y Canadá, desde $1.95/mes, con SMS entrantes en el panel y reenviados a tu webhook number.sms_received. Que un número de EE. UU. o Canadá encaje con una cuenta de Tokopedia depende de la propia cuenta, así que compruébalo antes de confiar en ello.

¿Cuáles son las reglas para probar Tokopedia de forma responsable?

Respeta los términos de Tokopedia, mantén una cuenta por persona o empresa real y usa OTP Route solo para probar y operar tus propios productos y cuentas legítimos. El nombre del servicio es una marca de su titular, y OTP Route no tiene ninguna afiliación con él. La Política de Uso Aceptable de OTP Route se aplica a cada pedido.

La facturación sale de un monedero prepago en USD recargado con tarjeta, USDT o USDC, con una factura en PDF por cada recarga y sin cuota mensual. Las cuentas de desarrollador pueden solicitar el modo sandbox para pruebas simuladas de extremo a extremo.

Preguntas frecuentes

¿Puedo probar el inicio de sesión de Tokopedia de mi herramienta para vendedores sin el teléfono de un miembro del equipo?

Sí. Pide una activación de Tokopedia en el OTP Gateway y lee el código en el panel o a través de la API.

¿Qué id de servicio usa la API para Tokopedia?

Es tokopedia. Combínalo con un id de país, como id para Indonesia.

¿Acepta Tokopedia todos los números virtuales?

No. Algunos flujos pueden rechazar números virtuales, y por eso una activación sin código se reembolsa por completo.

¿Qué país es mejor para un número de teléfono de Tokopedia?

Normalmente Indonesia, porque es donde operan la mayoría de las cuentas, pero elige el país que coincida con la cuenta y el caso de prueba.

¿Pagaré si Tokopedia envía el OTP por otro canal?

No, si no llega ningún SMS al número. Cuando la ventana de 20 minutos se cierra vacía, el importe completo vuelve a tu monedero.

¿Cómo evito que las entregas duplicadas de webhooks rompan mis pruebas?

Guarda los ids de activación ya procesados e ignora las repeticiones, tras verificar la cabecera de firma en cada solicitud.

¿Puedo conservar un número a largo plazo para una cuenta de tienda de Tokopedia?

Los números dedicados están disponibles en EE. UU. y Canadá desde el panel; otros países no tienen una línea de largo plazo de autoservicio.

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.