Cómo recibir códigos SMS OTP de Kosovo por API o desde el panel

¿Por qué un equipo de producto necesitaría un número +383?

Kosovo es un mercado pequeño con una gran presencia en el extranjero: una amplia diáspora vive en Alemania, Suiza y otras zonas de Europa occidental, y muchas de esas personas conservan un número kosovar para la familia y la banca. Las apps que atienden a ese público, desde viajes hasta transferencias de dinero, necesitan ver qué experimenta un usuario +383 al registrarse.

La localización es el otro motor. El albanés y el serbio son ambos oficiales, así que un flujo traducido a cualquiera de los dos idiomas merece una prueba real de extremo a extremo en lugar de una revisión de capturas. Un número de verificación de Kosovo del OTP Gateway permite a QA hacer esa comprobación desde cualquier oficina.

Los equipos de operaciones regionales con sede en Pristina o que cubren los Balcanes Occidentales tienen un tercer motivo: los perfiles de empresa registrados con un contacto local a veces piden un código nuevo, y encaminarlo por una herramienta compartida y auditable es mejor que ir pasando de mano en mano el móvil de un empleado.

¿Qué apps hay ahora mismo en la ruta de Kosovo?

La instantánea de hoy muestra más de 400 servicios para Kosovo. Entre los populares que se ofrecen actualmente están WhatsApp, Viber, Telegram, Facebook, Instagram, TikTok, Google (Gmail y YouTube), Microsoft y Outlook, Amazon, Snapchat, Netflix, Airbnb, Uber y Flipkart.

La lista es más corta que en los mercados europeos más grandes y cambia con más frecuencia, así que toma cualquier lista escrita como una pista. La respuesta definitiva es lo que devuelvan GET /api/v1/countries y el panel en el momento en que hagas el pedido.

La API OTP de Kosovo en la práctica

El id de país es xk. Una integración típica resuelve los ids de servicio con GET /api/v1/services, comprueba el costo con GET /api/v1/prices?country=xk&service=<id> y luego abre una activación con POST /api/v1/activations y un cuerpo como {"service": "telegram", "country": "xk"}. La respuesta trae el número y un id de activación que guardas para más tarde.

A partir de ahí, el código te llega como un webhook activation.sms_received, firmado en el encabezado X-OTPRoute-Signature con HMAC-SHA256 sobre "<t>.<raw body>". Rechaza las marcas de tiempo antiguas y usa el id de activación como clave de tu manejador para que una entrega reintentada se procese una sola vez. El polling de GET /api/v1/activations/{id} también funciona cuando un trabajo de CI no tiene una URL pública. Consulta la guía de integración para ver ejemplos completos.

¿Qué cambió cuando Kosovo obtuvo el +383 y cómo deben guardarse los números?

Kosovo recibió su propio código de país, +383, solo a finales de la década de 2010. Antes de eso, sus redes móviles usaban códigos prestados, entre ellos los de Mónaco y Eslovenia, y algunos registros de clientes antiguos todavía contienen números en esos formatos. Si importas datos heredados, márcalos en lugar de reescribirlos automáticamente.

Los números nacionales empiezan por el prefijo troncal 0; un móvil mostrado localmente como 044 123 456 es +383 44 123 456 en E.164. Guarda la forma internacional, elimina el cero al recibir la entrada y aplica el formato solo al mostrarlo. El texto en albanés usa letras como la ë, que quedan fuera del alfabeto GSM básico, así que un mensaje localizado puede enviarse en UCS-2 con segmentos más cortos.

¿Qué debería pasar cuando un código de Kosovo llega tarde o no llega?

Dale a la activación sus 20 minutos completos. Cuando la ventana se cierra sin un SMS, o cancelas, el cargo se revierte al monedero automáticamente y se dispara activation.expired o activation.cancelled. Siguientes pasos razonables:

• inténtalo de nuevo tras una pausa o elige una ruta vecina, como Albania, si tu prueba lo permite;
• comprueba que el servicio de destino admita números virtuales;
• añade un retardo progresivo a los reintentos automáticos en lugar de pedir en bucle.

Líneas de largo plazo, monedero y sandbox para proyectos en Kosovo

OTP Route no tiene un número de largo plazo autogestionado para Kosovo. Su línea de Números Dedicados, desde $1.95/mes, cubre solo dos países: Estados Unidos y Canadá. Para una línea +383 duradera, escribe a [email protected]; que se pueda gestionar o no depende de las normas locales.

El gasto sale de un único monedero prepago en USD, de pago por uso, recargado con tarjeta o USDT/USDC, con una factura en PDF enviada por correo por cada recarga. Los desarrolladores pueden solicitar el modo sandbox en una cuenta de desarrollo para recibir números y códigos simulados mientras configuran los webhooks. Detalles en precios.

Preguntas frecuentes

¿Puedo comprobar con un número real de Kosovo el registro de mi app en albanés?

Sí. Pide un número +383 para pruebas en el OTP Gateway, inicia el registro en albanés y el código aparece en el panel y en tu webhook.

¿Qué id usa Kosovo en la API de verificación por SMS?

Kosovo es xk en cada endpoint que recibe un país, incluidos GET /api/v1/prices y POST /api/v1/activations.

¿Cuánto cuesta un número de verificación de Kosovo?

Desde $0.20 por código; la tarifa exacta depende del servicio y se muestra antes de pedir, o la devuelve el endpoint de precios.

¿Por qué veo menos servicios para Kosovo que para Alemania?

La cobertura depende de lo que nuestros socios de red pueden enrutar a cada país, y los mercados más pequeños tienen listas más cortas. Consulta la lista en vivo antes de planificar una ejecución de pruebas.

¿Qué pasa con mi dinero si los OTP de Kosovo nunca llegan?

Vuelve al monedero íntegramente cuando la ventana de 20 minutos termina sin un SMS, o de inmediato si cancelas.

¿Los antiguos números +377 o +386 siguen perteneciendo a usuarios de Kosovo?

Algunos registros heredados pueden contenerlos, pero los números nuevos usan +383. Trata los formatos antiguos como datos para revisar, no como algo que convertir a ciegas.

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

No de forma autogestionada. Cada número del gateway cubre un solo código, y las líneas de largo plazo son un producto de EE. UU. y Canadá; escribe a [email protected] para preguntar por Kosovo.

¿Hay reglas sobre cómo uso los números de OTP Route?

Sí. Usa OTP Route solo para tus propios productos y cuentas de negocio legítimos, respeta los términos de cada servicio y la Política de Uso Aceptable. Regístrate para empezar.

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.