Español
Cómo recibir OTP de Zalo en números de OTP Route mediante la API
Un equipo recibe un código de verificación de Zalo pidiendo un número de un solo uso para el servicio zalo en el OTP Gateway de OTP Route, introduciéndolo en Zalo y leyendo el código en el panel, mediante una consulta REST o con un webhook firmado. El precio parte de $0.20 por código según el país, y si no llega ningún código dentro de la ventana de 20 minutos se reembolsa el monedero por completo.
¿Cómo es el flujo de la API de códigos de verificación de Zalo?
El id del servicio es zalo. Las llamadas van a https://otproute.com/api/v1 con una clave Bearer con prefijo or_live_, emitida en la consola para desarrolladores.
- Obtén los ids de país con
GET /api/v1/countries; Vietnam, por ejemplo, esvn. - Consulta el precio y la disponibilidad en vivo con
GET /api/v1/prices?country=vn&service=zalo. - Crea la activación:
POST /api/v1/activationscon{"service": "zalo", "country": "vn"}. Guarda el id de la activación y el número devuelto. - Introduce el número en la pantalla de teléfono de Zalo de la cuenta de prueba que controlas.
- Recoge el código por webhook o por polling, o cierra el pedido con
POST /api/v1/activations/{id}/cancel.
Comprobar el saldo con GET /api/v1/balance al inicio de la suite evita sorpresas a mitad de la ejecución. Consulta la documentación de la API para ver la forma completa de las solicitudes.
Cómo construir un receptor de webhooks para códigos de Zalo
Registra un endpoint en la consola para desarrolladores y suscríbete a activation.sms_received, activation.expired y activation.cancelled. Cada solicitud lleva una cabecera X-OTPRoute-Signature con el formato 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 antiguas.
Haz el manejador idempotente guardando los resultados con el id de la activación como clave. Si el mismo evento llega dos veces, la segunda escritura no debe tener efecto. Los equipos sin endpoint público pueden hacer polling a GET /api/v1/activations/{id}; el límite de 300 solicitudes por minuto deja margen para un intervalo de consulta corto en varias pruebas en paralelo.
¿Cuándo pide Zalo un número de teléfono?
Zalo es una aplicación vietnamita de mensajería y red social, y el número de teléfono actúa como identificador principal de la cuenta. Normalmente se pide un código al crear una cuenta, al iniciar sesión en un dispositivo nuevo y al recuperar el acceso. Los pasos exactos los decide Zalo y pueden cambiar, así que un plan de pruebas debe cubrir cada pantalla en lugar de suponer una secuencia fija.
Para los equipos de QA esto importa porque una integración de mensajería, una mini app o un canal de atención al cliente construido en torno a Zalo suele necesitar una cuenta de prueba nueva y verificada antes de poder ejecutar cualquier otro escenario.
¿En qué países se pueden recibir OTP de Zalo con OTP Route?
Las rutas de Zalo figuran en 198 países. Entre ellos están Vietnam, Estados Unidos, Japón, Corea del Sur, Taiwán, Australia, Canadá, Camboya, Laos, Tailandia, Malasia, Singapur, Alemania, Francia y Reino Unido.
Elige el país que corresponda a la cuenta que estás probando. Un lanzamiento en Vietnam necesita números +84 para reproducir lo que ven los usuarios locales, mientras que un equipo que atienda a comunidades vietnamitas en el extranjero puede preferir números de los países donde viven esos clientes. El país también influye en el precio y la disponibilidad, por eso conviene consultar primero el endpoint de precios.
Pasos en el panel para una prueba de verificación por SMS de Zalo
No todos los miembros de un proyecto escriben código. En el panel, elige Zalo como servicio, selecciona el país, confirma el precio que se muestra y haz el pedido. Copia el número en Zalo; el código aparece junto al pedido cuando llega el SMS. Cancelar desde la misma pantalla devuelve el importe completo. El registro en el propio panel requiere una dirección de correo y un código de 6 dígitos enviado por email, o inicio de sesión con Google, y la autenticación en dos pasos TOTP puede proteger el acceso del equipo.
¿Por qué puede no llegar un código de Zalo?
La entrega depende del servicio y de la ruta, por lo que no hay un tiempo de espera fijo. Zalo también puede rechazar algunos números virtuales, y para eso existe el reembolso. Si no aparece nada:
- Deja el pedido abierto hasta que termine la ventana de 20 minutos, o cancélalo; en ambos casos el monedero recupera el dinero.
- Inténtalo de nuevo más tarde, o cambia a otro país que encaje con la prueba.
- No repitas pedidos en bucle rápido; añade un backoff en los trabajos automatizados.
- Comprueba que la propia cuenta de prueba no esté bloqueada ni limitada por Zalo.
¿Debe una cuenta de prueba de Zalo usar un número dedicado?
Un número del OTP Gateway gestiona un único código. Si una cuenta de staging o de soporte debe volver a iniciar sesión el mes que viene, el número dedicado es la mejor opción: una línea de EE. UU. o Canadá desde $1.95/mes que conservas mientras se renueve, con SMS entrantes en el panel y en el webhook number.sms_received. Más información en números virtuales.
Usa cualquiera de las dos opciones con responsabilidad. Respeta los términos de Zalo, mantén una cuenta por persona o empresa real y usa OTP Route solo para probar y operar tus propias cuentas y productos legítimos. Zalo es una marca de su titular, y OTP Route no está afiliado a ella.
Preguntas frecuentes
¿Qué id de servicio usa la API de OTP Route para Zalo?
Es zalo, que se envía en el cuerpo de POST /api/v1/activations junto con un id de país.
¿Puedo recibir un OTP de Zalo en un número fuera de Vietnam?
Sí. Las rutas de Zalo figuran en 198 países, y el endpoint de precios devuelve en vivo la disponibilidad de cada uno.
¿Me cobran si Zalo rechaza el número virtual?
No. Si no llega ningún código al número en 20 minutos, o si cancelas, el importe completo se reembolsa al monedero.
¿Sirve un número virtual para Zalo en una cuenta que necesito a largo plazo?
Un número de un solo uso no. Para inicios de sesión recurrentes, un número dedicado de EE. UU. o Canadá que conservas mientras se renueva es la opción más segura.
¿Cómo pago la verificación por SMS de Zalo para pruebas?
Recarga un monedero prepago en USD con tarjeta o USDT/USDC; no hay cuota mensual y cada recarga incluye una factura en PDF.
¿Puedo probar la integración con Zalo sin gastar dinero?
Sí. Cuando el soporte pasa una cuenta de desarrollo a sandbox, los pedidos de Zalo devuelven números y códigos simulados, de modo que el código de webhooks y polling se puede validar antes de gastar de verdad.
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.