Códigos de verificación salvadoreños (+503) para equipos de QA y de lanzamiento

¿Código de un solo uso o línea de larga duración: qué necesita una prueba salvadoreña?

Empieza por la forma de la prueba, porque ella decide el producto.

• Un único paso de verificación (registro, cambio de teléfono, una comprobación reforzada) corresponde al OTP Gateway. Pides un número +503 para un servicio, el código llega una vez y el número termina ahí.
• Una cuenta que debe seguir iniciando sesión durante semanas necesita una línea propia. Los Dedicated Numbers son un producto de EE. UU. y Canadá desde $1.95/month, que se compra al instante desde el panel, con SMS entrantes, SMS salientes y llamadas desde el navegador.

Para El Salvador no hay Dedicated Number en autoservicio. Si tu equipo realmente necesita una línea salvadoreña de larga duración, escribe a [email protected]; que se pueda gestionar depende de la normativa local y no está garantizado. Muchos equipos resuelven el caso del "inicio de sesión repetido" con una línea de EE. UU., cuando el servicio bajo prueba la acepta. Para un despliegue en El Salvador, sopesa ambos caminos con las notas de números temporales frente a dedicados.

¿Cómo se deben guardar y validar los números +503?

El Salvador usa un plan de numeración cerrado de 8 dígitos sin prefijo troncal. El número que un local escribe en un formulario son los mismos 8 dígitos que siguen al +503 en la forma internacional, así que la normalización consiste sobre todo en quitar la puntuación: los locales suelen escribir los móviles como dos bloques de cuatro separados por un guion.

• Guarda la forma E.164, +503 seguido de ocho dígitos, en una sola columna.
• Los móviles suelen empezar por 6 o 7; las líneas fijas suelen empezar por 2. Un validador que acepte solo esos dígitos iniciales detecta la mayoría de los errores de escritura.
• Rechaza un 0 inicial de más. Los usuarios acostumbrados a otros planes latinoamericanos a veces lo añaden, y algunas plataformas de SMS descartan el mensaje sin avisar.

Las plantillas de SMS de tu app para este mercado suelen estar en español. Caracteres como á, í u ó quedan fuera del alfabeto GSM básico, así que una plantilla que los use puede pasar a codificación UCS-2 y acortar cada segmento. Mantén el código cerca del principio del mensaje para que sobreviva a una división.

¿Por qué prueban los equipos los flujos de registro en El Salvador?

Se repiten algunos patrones:

• Lanzamientos en Centroamérica. Un producto que se despliega por Guatemala, Honduras y El Salvador quiere revisar el paso telefónico de cada país antes de que salgan los anuncios.
• Clientes de la diáspora. Muchos salvadoreños viven en Estados Unidos y conservan un número +503 para su familia, así que los productos de remesas, pagos y mensajería ven números salvadoreños aunque la dirección del usuario sea estadounidense. Consulta onboarding fintech para ese flujo.
• QA de localización. Los textos en español, el selector de país y las máscaras de número necesitan un código salvadoreño real para confirmar que las pantallas funcionan de extremo a extremo.
• Precios en dólares estadounidenses. El dólar estadounidense es la moneda oficial de El Salvador, lo que hace del mercado un lugar cómodo para probar juntos el pago y el onboarding.

¿Cómo es la secuencia de llamadas de la API OTP de El Salvador?

Todas las solicitudes van a https://otproute.com/api/v1 con una clave Bearer con prefijo or_live_, creada en la consola de desarrolladores (hasta 10 claves, 300 solicitudes por minuto). El id de país de El Salvador es sv.

1. Obtén GET /api/v1/countries y GET /api/v1/services y guarda los ids en caché.
2. Lee el precio en vivo con GET /api/v1/prices?country=sv&service=<id>; también te dice si hay una ruta disponible ahora mismo.
3. Crea el pedido con POST /api/v1/activations y un cuerpo como {"service": "telegram", "country": "sv"}. Guarda el id de activación y el número.
4. Haz que la versión salvadoreña de tu app envíe su SMS de verificación a ese número.
5. Espera el evento activation.sms_received en tu endpoint; si no llega, consulta GET /api/v1/activations/{id} cada pocos segundos.
6. Si el flujo se abandona, llama a POST /api/v1/activations/{id}/cancel para que los fondos vuelvan de inmediato.

Cada webhook lleva X-OTPRoute-Signature: t=<unix>,v1=<hex>, un HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo sin procesar con el secreto de tu endpoint. Verifícalo y descarta las marcas de tiempo caducadas; cómo proteger los webhooks OTP lo explica paso a paso. Quienes no programan pueden hacer lo mismo desde el panel: elige El Salvador, elige un servicio, confirma el precio en vivo y observa cómo aparece el código en la tarjeta de activación.

¿Qué servicios se pueden verificar con un número salvadoreño?

La instantánea en vivo muestra más de 900 servicios con rutas de El Salvador. Entre los populares están WhatsApp, Facebook, Instagram, TikTok, Uber, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Telegram, Signal, LinkedIn y ChatGPT (OpenAI). La disponibilidad cambia a lo largo del día, y por eso debe guiar a tu ejecutor de pruebas el endpoint de precios y no una lista fija.

Algunos servicios rechazan los números que clasifican como virtuales. Eso queda fuera de nuestro control, y es la razón de que exista la regla de reembolso.

¿Qué pasa si el código salvadoreño nunca llega?

Un código +503 lento todavía no es uno fallido, así que deja el pedido abierto durante los 20 minutos completos. Si no llega nada, el pedido caduca, se dispara activation.expired y el importe completo vuelve automáticamente a tu monedero. Después:

• confirma que el servicio acepta números virtuales para este tipo de paso;
• inténtalo de nuevo más tarde, o elige otra ruta de servicio, en lugar de repetir el pedido en bucle rápido;
• comprueba que tu propia app envió realmente el SMS al número exacto devuelto, en formato E.164.

Más consejos de solución de problemas útiles para Centroamérica están en cómo reducir las entregas fallidas de OTP.

¿Cómo se gestiona la facturación de los pedidos de El Salvador?

OTP Route usa un único monedero prepago en USD, de pago por uso, sin cuota mensual ni plan que elegir. Se recarga con tarjeta o con las stablecoins USDT/USDC, y llega a tu bandeja una factura en PDF tras cada recarga o compra de número. Para el trabajo de integración, una cuenta de desarrollo puede pasarse a sandbox a petición, devolviendo números y códigos simulados para que todo el ciclo funcione sin gastar fondos del monedero. Las tarifas actuales están en la página de precios.

Preguntas frecuentes

¿Puedo probar el registro de El Salvador de mi app sin una SIM local?

Sí. Pide un número +503 en el OTP Gateway para el servicio que estás probando, provoca el SMS y lee el código en el panel o mediante la API.

¿Los números salvadoreños tienen un prefijo troncal como el 0?

No. Los números de El Salvador tienen ocho dígitos sin prefijo troncal, así que la forma internacional es simplemente +503 más esos ocho dígitos.

¿Cuál es el id de país de El Salvador en la API de OTP Route?

Usa sv en las consultas de precios y en el cuerpo de la activación, por ejemplo GET /api/v1/prices?country=sv&service=<id>.

¿Me cobran si el número +503 no recibe ningún código?

No. Si no llega ningún SMS dentro de la ventana de 20 minutos, o cancelas antes, el importe completo se devuelve automáticamente a tu monedero.

¿Puedo conservar un número salvadoreño para inicios de sesión repetidos?

No como producto de autoservicio. Los Dedicated Numbers de larga duración se ofrecen en Estados Unidos y Canadá; para El Salvador puedes escribir a [email protected] para consultarlo, sin promesa de disponibilidad.

¿Está OTP Route pensado para crear muchas cuentas?

No. Es para probar y operar tus propios productos y cuentas legítimos, dentro de las condiciones de cada servicio y de la Política de Uso Aceptable de OTP Route.

¿Puedo ejecutar el flujo salvadoreño en CI sin gastar dinero?

Sí. Una cuenta de desarrollo puede pasarse a sandbox a petición, y devuelve números y códigos simulados para que tu pipeline ejercite toda la ruta de la API.

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.