Español
Números de verificación colombianos para QA, lanzamientos y enrutamiento OTP
Sí, OTP Route te permite recibir códigos de verificación colombianos (+57) para registros o inicios de sesión de un solo uso, ya sea en el panel o a través de la API REST y los webhooks firmados. El OTP Gateway cobra desde $0.20 por código y solo pagas cuando el SMS llega dentro de la ventana de 20 minutos. Los equipos lo usan para probar el onboarding en español del mercado colombiano sin comprar tarjetas SIM locales.
Cuatro llamadas a la API para recibir códigos SMS OTP de Colombia
Una integración con la API OTP de Colombia necesita solo un puñado de solicitudes. Empieza confirmando que la ruta está abierta con GET /api/v1/prices?country=co&service=whatsapp, cambiando el id por el servicio que estés probando; la respuesta trae el precio en vivo de ese par. Después, crea el pedido con POST /api/v1/activations y un cuerpo JSON que indique el servicio y co como país. Recibes un id de activación y el número +57 que debes escribir en la app que estás probando.
Luego espera el mensaje. La mayoría de los equipos registra un endpoint de webhook y escucha activation.sms_received, mientras que otros consultan GET /api/v1/activations/{id} a intervalos tranquilos. Por último, ordena: si la prueba cambió de rumbo, POST /api/v1/activations/{id}/cancel libera los fondos reservados. La documentación para desarrolladores describe cada solicitud al detalle.
¿Qué apps colombianas están en la ruta hoy?
El enrutamiento OTP para Colombia abarca más de 1,900 servicios en la última captura. Entre los más solicitados están WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal y Netflix. La capacidad cambia a lo largo del día, así que una prueba programada debe preguntar a GET /api/v1/services y al endpoint de precios qué está disponible en ese momento en lugar de fiarse de una lista fija.
Cómo dar formato a los móviles +57 para guardarlos en E.164
Los móviles colombianos llevan diez dígitos después del código de país y empiezan por 3, lo que da una forma E.164 del tipo +57 3XX XXX XXXX. A nivel nacional se marcan sin cero inicial, así que la normalización es sencilla: quita espacios, guiones y paréntesis, conserva el signo más y el 57, y guarda una única cadena canónica. Una comprobación en el cliente del 3 inicial ayuda a que quien pega un número fijo vea un mensaje claro en lugar de un fallo silencioso en el paso del SMS.
¿Qué lleva a los equipos de QA al mercado colombiano?
Colombia es uno de los mayores mercados hispanohablantes, y muchos lanzamientos en Latinoamérica empiezan allí o cerca. Los SMS de verificación suelen llegar en español, así que una revisión de localización debe confirmar que tu propia plantilla suena natural, que los caracteres con tilde sobreviven a la codificación y que los dígitos se distinguen fácilmente dentro de una frase más larga. Los productos de transporte, reparto, pagos y marketplaces dependen de las verificaciones telefónicas en la región, y por eso un número +57 para pruebas aparece una y otra vez en las listas de control de lanzamiento. Nuestra página de pruebas de QA reúne patrones que funcionan con cualquier API de verificación por SMS.
El código +57 se retrasa. ¿Y ahora qué?
Cada activación permanece abierta 20 minutos. Si la ventana se cierra sin SMS, o cancelas antes, el importe completo vuelve automáticamente a tu monedero y tu endpoint recibe activation.expired o activation.cancelled. Antes de volver a intentarlo:
- comprueba que la app que estás probando acepta números virtuales;
- deja que termine la ventana actual en lugar de apilar pedidos nuevos;
- espacia los reintentos en vez de pedir en bucle rápido;
- prueba en otro momento o con otra ruta para el mismo servicio.
El artículo sobre cómo reducir las entregas fallidas de OTP explica la lógica de cada paso.
¿Puedo conservar una línea colombiana durante meses?
No en autoservicio. Los Dedicated Virtual Numbers, que incluyen SMS entrantes y salientes además de llamadas desde el navegador, se venden solo para Estados Unidos y Canadá, desde $1.95/month. Desde el panel no se puede comprar ninguna línea +57 de larga duración. Si tu operación necesita una, escribe a [email protected]; que se pueda gestionar algo depende de la normativa local y no puede prometerse de antemano.
Cómo pagar las verificaciones de Colombia
OTP Route funciona con un monedero prepago en USD, sin cuota mensual ni plan que elegir. Se recarga con tarjeta o con stablecoins USDT/USDC, y finanzas recibe una factura en PDF por correo tras cada recarga. Las rutas de Colombia empiezan desde $0.20 por código y varían según el servicio; la cifra exacta se muestra antes de confirmar. Durante el trabajo de integración puedes pedir a soporte que cambie una cuenta de desarrollo a sandbox, donde los números y códigos simulados te permiten ensayar todo el flujo sin tocar los fondos del monedero. Las tarifas vigentes están en la página de precios.
Preguntas frecuentes
¿Puedo probar el registro colombiano de mi app sin una SIM local?
Sí. Pide un número +57 para el servicio que estás comprobando, introdúcelo en el formulario de registro y lee el código en el panel o desde tu webhook. No hay que enviar ni activar nada físico.
¿Cómo pido un número de verificación de Colombia desde el panel?
Inicia sesión, abre el OTP Gateway, elige el servicio y Colombia, revisa el precio y confirma. El número aparece en pantalla y el código se muestra a su lado cuando llega el SMS.
¿Qué id de país usa la API para Colombia?
Usa co en el campo country y en las consultas de precios. Los ids de servicio salen de GET /api/v1/services, por ejemplo telegram o uber.
¿Pago por un número +57 que nunca recibe un código?
No. Cuando la ventana de 20 minutos termina sin SMS, o cuando cancelas, el cargo completo vuelve a tu monedero de forma automática.
¿En qué idioma llegará el SMS de verificación colombiano?
Depende del remitente, aunque los usuarios colombianos ven sobre todo plantillas en español. Extrae los dígitos en lugar de buscar un texto fijo, porque las plantillas cambian sin avisar.
¿Puede mi pipeline de CI recibir por sí solo códigos SMS OTP de Colombia?
Sí. Crea la activación desde el pipeline, espera el webhook o consulta la activación, y pasa el código a la prueba. Nuestra nota sobre pruebas de OTP en CI trata los tiempos de espera y la limpieza.
¿Cómo sé que un webhook realmente viene de OTP Route?
Cada solicitud lleva X-OTPRoute-Signature con una marca de tiempo y un HMAC-SHA256 de esa marca, un punto y el cuerpo sin procesar, calculado con el secreto de tu endpoint. Recalcúlalo, compara en tiempo constante y descarta las marcas de tiempo antiguas.
¿Hay límites sobre lo que puedo verificar con un número +57?
Sí. Usa los números solo para tus propios productos y cuentas empresariales legítimas, respeta los términos de cada servicio y ten presente que la Política de Uso Aceptable de OTP Route se aplica a cada pedido.
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.