Español
Números de verificación de Guatemala (+502) para pruebas y operaciones
Sí, OTP Route puede recibir códigos SMS de verificación de Guatemala (+502) en un número de un solo uso de su OTP Gateway, y lees cada código en el panel o lo recoges a través de la API y los webhooks firmados. Los códigos parten de $0.20 por código, el precio en vivo de cada servicio se muestra antes de pedir, y si no llega nada en 20 minutos el cargo se devuelve a tu monedero.
¿Por qué merece Guatemala una ejecución de pruebas dedicada?
Guatemala es el país más poblado de Centroamérica y, para muchos equipos, el primer mercado de un despliegue regional en español. El español es el idioma oficial, mientras que una gran parte de la población también habla alguna de las muchas lenguas mayas, algo que importa si los textos de tu onboarding o el contenido de soporte van más allá del español.
Hay tres situaciones que se repiten:
- Lanzamientos regionales que necesitan revisar la pantalla de entrada del teléfono, la redacción del SMS en español y el paso de verificación en una ruta +502 real (verificación de apps móviles).
- Productos para la diáspora, como apps de remesas o de llamadas que usan guatemaltecos que viven en Estados Unidos, donde la cuenta está vinculada a un número del país de origen.
- Equipos de operaciones que gestionan perfiles de negocio para clientes guatemaltecos que prefieren no vincular el teléfono personal de nadie (equipos de operaciones).
¿Cómo se formatean los números de teléfono de Guatemala?
Guatemala usa números nacionales de ocho dígitos y no tiene prefijo de troncal, así que no hay ningún cero inicial que eliminar. La forma E.164 es simplemente +502 seguido de esos ocho dígitos, escrita como +502 xxxx xxxx.
Esa longitud corta hace tropezar a los validadores de formularios escritos pensando en números norteamericanos de diez dígitos. Añade casos de prueba para una entrada de ocho dígitos, para usuarios que escriben el 502 sin el signo más y para espacios o guiones en medio. Guarda la cadena E.164 normalizada y evita adivinar si un número es móvil o fijo solo por su longitud, porque ambos comparten los mismos ocho dígitos.
¿Puedo recibir códigos SMS OTP de Guatemala a través de la API?
Sí. La API OTP de Guatemala usa el id de país gt contra la URL base https://otproute.com/api/v1, autenticada con una clave Bearer con prefijo or_live_.
Empieza con GET /api/v1/services para encontrar el id del servicio y luego comprueba la cotización actual con GET /api/v1/prices?country=gt&service=<id>. Crea el número con POST /api/v1/activations y el cuerpo {"service": "<id>", "country": "gt"}. Cuando tu app envíe el SMS, consulta GET /api/v1/activations/{id} o deja que un endpoint de webhook reciba activation.sms_received. Verifica la cabecera X-OTPRoute-Signature, un HMAC-SHA256 sobre la marca de tiempo y el cuerpo sin procesar, y rechaza las marcas de tiempo antiguas, como se describe en proteger los webhooks de OTP. La visión general para desarrolladores enumera los límites: 10 claves, 5 endpoints de webhook, 300 solicitudes por minuto.
¿Qué servicios hay ahora mismo en la ruta +502?
Hay más de 1,600 servicios listados para Guatemala. La instantánea actual de los populares incluye WhatsApp, Facebook, TikTok, Telegram, Instagram, Google (Gmail y YouTube), X (Twitter), Uber, Amazon, Discord, LinkedIn, Signal, Netflix y Microsoft y Outlook. La disponibilidad rota a lo largo del día, y por eso la API devuelve disponibilidad en vivo en lugar de un catálogo fijo.
¿Hay una vía sin código para el personal de soporte y operaciones?
Cualquier persona del equipo puede pedir desde el panel después de registrarte con tu correo y un código de 6 dígitos, o con el inicio de sesión de Google. Elige Guatemala, selecciona el servicio, confirma el precio mostrado y copia el número +502 en la app. El código aparece en la misma pantalla cuando llega. Activar la autenticación en dos pasos (TOTP) en la propia cuenta de OTP Route es un paso sensato para el acceso compartido del equipo.
¿Por qué no apareció mi código +502 y qué debo probar?
El número permanece activo durante 20 minutos, y el cargo solo se aplica cuando se entrega un código. Si la ventana caduca o cancelas, el importe completo vuelve al monedero de forma automática.
- Espera a que termine la ventana; el tiempo de entrega depende del servicio y de la ruta.
- Reintenta más tarde, o por otra ruta de servicio si se ofrece alguna.
- Confirma que el servicio acepta números virtuales, ya que algunos los rechazan.
- No lances pedidos nuevos en un bucle cerrado; deja un retroceso entre intentos.
¿Y los números guatemaltecos de largo plazo, la facturación y el sandbox?
En OTP Route no existe un número guatemalteco de largo plazo de autoservicio. Las líneas dedicadas son solo para Estados Unidos y Canadá, desde $1.95/month. Si necesitas una línea +502 duradera, escribe a [email protected]; que se pueda arreglar algo depende de la normativa local y no está asegurado.
El pago se hace mediante un único monedero prepago en USD sin plan ni cuota mensual, recargado con tarjeta o USDT/USDC, con una factura en PDF enviada por correo por cada recarga. Para trabajos de integración, una cuenta de desarrollo puede pasar a sandbox bajo petición, de modo que números y códigos simulados fluyan por tu código sin coste.
Preguntas frecuentes
¿Puedo probar nuestro registro en español para Guatemala sin una SIM local?
Sí. Pide un número gt en el OTP Gateway, introdúcelo en tu app y lee el código en español en el panel o desde tu webhook.
¿Los números de Guatemala necesitan un cero inicial?
No. Guatemala no tiene prefijo de troncal, así que un número es simplemente +502 más ocho dígitos.
¿Cuál es lo más barato que puede costar un código +502?
Los precios parten de $0.20 por código; la cifra de un servicio concreto la devuelve GET /api/v1/prices y se muestra antes de confirmar.
¿Se me cobrará si el SMS de verificación nunca llega?
No. Sin un código entregado dentro de la ventana de 20 minutos, o tras una cancelación, el importe completo vuelve al monedero.
¿Puede OTP Route mantener el mismo número +502 para mi equipo a largo plazo?
No por autoservicio. Los números del OTP Gateway atienden un solo código, y las líneas de largo plazo son solo de Estados Unidos y Canadá, así que consulta a [email protected] sobre Guatemala.
¿Qué reglas se aplican al uso que damos a estos números?
Los términos de cada servicio más la Política de uso aceptable de OTP Route. Usa los números solo para probar o gestionar tus propios productos y cuentas de empresa legítimos.
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.