Integrar la verificación SMS +82 en tu pipeline de lanzamiento para Corea

¿Por qué endpoints pasa una activación +82?

Empieza por la API de verificación SMS, porque ahí es donde acaban la mayoría de los planes de prueba para Corea. Cada llamada va a https://otproute.com/api/v1 con una clave Bearer que empieza por or_live_, obtenida en la consola de desarrollador.

• GET /api/v1/countries devuelve kr para Corea del Sur; GET /api/v1/services da los ids de servicio.
• GET /api/v1/prices?country=kr&service=<id> informa del precio actual y de si la ruta está abierta.
• POST /api/v1/activations con {"service": "kakaotalk", "country": "kr"} reserva un número +82 y devuelve un id de activación.
• GET /api/v1/activations/{id} muestra el estado y, una vez recibido, el código.
• POST /api/v1/activations/{id}/cancel libera un número que ya no necesitas.
• GET /api/v1/balance permite que una suite falle pronto cuando el monedero está bajo.

El límite de la cuenta es de 300 solicitudes por minuto, así que hacer polling cada pocos segundos en trabajos paralelos es cómodo. La guía de integración muestra un ciclo de solicitud completo.

¿Cómo encajan los webhooks firmados en una ejecución de pruebas para Corea?

El polling basta para un desarrollador individual; los trabajos de CI en paralelo quedan más limpios con entrega push. Registra hasta cinco endpoints y suscríbete a activation.sms_received, activation.expired y activation.cancelled.

Cada solicitud incluye X-OTPRoute-Signature: t=<unix>,v1=<hex>. Toma el cuerpo en bruto exactamente como se recibió, construye la cadena <t>.<raw body>, calcula HMAC-SHA256 con el secreto del endpoint y compáralo con v1 mediante una comparación en tiempo constante. Rechaza cualquier cosa con una marca de tiempo antigua para evitar repeticiones, e indexa tu manejador por el id de activación para que una entrega reintentada no resuelva dos veces la misma prueba. El artículo sobre HMAC cubre casos límite como la reserialización del cuerpo.

¿Qué problema suelen resolver los equipos de lanzamiento en Corea?

Corea del Sur es un mercado exigente para apps móviles y juegos, y los usuarios coreanos esperan una localización pulida. Los equipos prueban aquí antes de una versión, al añadir pantallas en coreano o cuando una cola de soporte informa de que los textos de verificación no llegan a usuarios coreanos. Sin una SIM local, resulta lento recibir SMS OTP de Corea del Sur y reproducir esos informes. Un número +82 de un solo uso de un servicio de OTP routing permite que un ingeniero reproduzca el flujo exacto desde cualquier oficina, y el código llega a las mismas herramientas que en cualquier otro mercado.

¿Cómo se formatean y almacenan los números de teléfono coreanos?

Los móviles coreanos se escriben a nivel nacional como 010 seguido de ocho dígitos. El 0 inicial es un prefijo troncal, así que la forma internacional lo elimina: +82 10 y luego los ocho dígitos restantes. Los formularios que aceptan ambos estilos deben normalizar a E.164 al recibirlos; guardar 010… y +8210… uno al lado del otro crea usuarios duplicados y búsquedas rotas.

Los mensajes de remitentes coreanos suelen estar escritos en hangul, que se envía como SMS Unicode, mientras que las apps globales siguen el idioma configurado en la cuenta. Analiza los códigos buscando el grupo de dígitos, no esperando una plantilla en inglés. Ten presente también que muchos servicios nacionales coreanos vinculan el registro a una verificación de identidad con nombre real a través del operador móvil del abonado. Esa comprobación está pensada para líneas personales, un número de un solo uso no la superará y no debes intentar eludirla.

¿Qué apps están abiertas ahora mismo en las rutas de Corea del Sur?

La instantánea de kr muestra más de 500 servicios. Entre las opciones habituales para un número de verificación de Corea del Sur están KakaoTalk, LINE, WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, TikTok, Discord, Netflix, Microsoft & Outlook, Amazon, Uber, ChatGPT (OpenAI) y Claude.

La cobertura cambia durante el día, así que confirma siempre con el endpoint de precios antes de hacer un pedido. Quien no es desarrollador puede hacer lo mismo desde el panel: crea una cuenta, abre OTP Gateway, elige el servicio y Corea del Sur, comprueba el precio mostrado, confirma y copia el número +82 en la app. El código aparece en pantalla en cuanto llega.

¿Qué hacer si una activación +82 sigue vacía?

La ventana de activación es de 20 minutos y solo se te cobra si llega un código. Cuando no llega nada:

• Concede a la ventana todo su tiempo antes de dar el pedido por fallido.
• Cancela e inténtalo más tarde, o elige otra ruta para ese servicio cuando haya alguna listada.
• Comprueba si la app rechaza líneas virtuales o exige verificaciones de identidad del operador; en ese caso, repetir el pedido no cambiará el resultado.
• No reintentes en un bucle apretado, que tiende a provocar limitaciones por parte del remitente.

Los pedidos sin respuesta o cancelados se reembolsan automáticamente. Respeta las condiciones de cada app y recuerda que la Política de Uso Aceptable de OTP Route se aplica a cada activación.

¿Existe un número coreano de larga duración y cómo funciona la facturación?

No hay ninguna línea +82 de larga duración de autoservicio. Los números dedicados se ofrecen solo en Estados Unidos y Canadá, desde $1.95/mes, para cuentas que deben seguir recibiendo mensajes. Para otras necesidades en Corea, escribe a [email protected]; la disponibilidad depende de la regulación local y no está asegurada.

OTP Gateway se paga desde un monedero prepago en USD, sin plan ni cuota mensual. Recárgalo con tarjeta o USDT/USDC y recibe una factura en PDF por cada recarga. A petición, una cuenta de desarrollo puede pasar a sandbox para que tu pipeline se ejecute con números y códigos simulados. Consulta precios para ver las tarifas en vivo.

Preguntas frecuentes

¿Puedo probar la verificación telefónica coreana de mi app sin una tarjeta SIM coreana?

Sí. Pide un número +82 a través de OTP Gateway, introdúcelo en tu app y recoge el código mediante la API, un webhook o el panel.

¿Incluyo el 0 inicial al introducir un número coreano en formato internacional?

No. Elimina el prefijo troncal, de modo que un móvil 010 pasa a ser +82 10 más ocho dígitos.

¿Cuánto cuesta un número +82 para pruebas?

Desde $0.20 por código, y el precio exacto depende del servicio. La cifra en vivo la proporcionan el endpoint de precios y el panel.

¿Un número de un solo uso superará la verificación coreana de nombre real?

No. Las comprobaciones de identidad basadas en el operador están vinculadas a líneas personales, así que usa OTP Route solo para flujos que aceptan códigos SMS ordinarios.

¿Se me cobra si KakaoTalk u otra app nunca envía el código?

No. Si no llega nada en 20 minutos, o cancelas, el pago se devuelve a tu monedero.

¿Puedo conservar un número surcoreano para inicios de sesión repetidos?

No en autoservicio. Cada número de un solo uso recibe un único código, y las líneas de larga duración se limitan a EE. UU. y Canadá.

¿Qué código de país espera la API para Corea del Sur?

El id de país es kr, que se usa en la consulta de precios y en el cuerpo de la activación.

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.