Cómo enrutar los OTP albaneses (+355) a tu pipeline de pruebas

¿Qué llamadas REST devuelven un número albanés y su código?

La API OTP de Albania es la misma API de verificación por SMS que se usa en todos los mercados; solo cambia el id de país. Las peticiones van a https://otproute.com/api/v1 con una clave Bearer con prefijo or_live_, generada en la consola de desarrollador. El id de Albania es al, así que una ejecución típica es así:

1. GET /api/v1/services resuelve el id de servicio que necesitas, por ejemplo telegram o google. Guarda la lista en caché entre ejecuciones.
2. GET /api/v1/prices?country=al&service=<id> lee el precio en vivo y confirma que la ruta está abierta ahora mismo.
3. POST /api/v1/activations con {"service": "telegram", "country": "al"} devuelve un id de activación y un número +355.
4. Tu prueba envía ese número en la pantalla de registro o inicio de sesión de la app que se está probando.
5. El código llega por webhook o sondeando GET /api/v1/activations/{id}; llama a POST /api/v1/activations/{id}/cancel si la prueba se aborta.

Una cuenta puede tener hasta 10 claves, de modo que staging, CI y el portátil de un compañero pueden tener cada uno la suya y revocarse por separado. El límite de 300 solicitudes por minuto deja margen para varias suites en paralelo. Los detalles de cada campo están en la referencia de la API.

¿Mis pruebas de Albania deben sondear o escuchar webhooks?

El sondeo es lo más rápido de implementar: consulta el endpoint de la activación cada pocos segundos hasta que cambie su estado. Cuando las suites se ejecutan en paralelo, un webhook resulta más ordenado. Registra hasta 5 endpoints y suscríbete a activation.sms_received, activation.expired y activation.cancelled.

Cada entrega va firmada. La cabecera X-OTPRoute-Signature tiene la forma t=<unix>,v1=<hex>, donde v1 es el HMAC-SHA256 de "<t>.<raw body>" calculado con el secreto del endpoint. Recalcúlalo sobre los bytes intactos de la petición, compara en tiempo constante y descarta todo lo que lleve una marca de tiempo antigua. Trata los eventos como identificados por el id de activación, de modo que una entrega reintentada nunca escriba dos veces. Nuestro artículo sobre la captura de OTP basada en webhooks recorre un manejador completo.

¿Cómo deben normalizarse los números +355 antes de llegar a mi base de datos?

Albania usa el código de país +355 y un prefijo troncal nacional 0. A nivel local, un móvil suele escribirse con ese 0 delante, como 06X XXX XXXX, mientras que la forma internacional lo omite: +355 6X XXX XXXX. Guarda la versión E.164 (+3556…, sin espacios) y aplica el formato local solo al mostrarlo.

Comprobaciones útiles al validar un número +355 para pruebas:

• Elimina el 0 inicial cuando el usuario escriba la forma nacional después de haber elegido ya +355.
• Rechaza un prefijo duplicado como +355 0 6X, que aparece cuando un formulario pega el código de país al número local sin más.
• Mantén espacios, guiones y paréntesis fuera del valor almacenado.

El texto que acompaña al código depende del servicio emisor y del idioma de la cuenta; el albanés y el inglés son habituales. Apunta a los dígitos en tu analizador en lugar de a una frase fija. Los equipos prueban este mercado al lanzarse en Albania, al localizar una app para hablantes de albanés en la región y en el extranjero, o al comprobar que una cuenta de operaciones regional sigue verificándose.

¿Qué puedo verificar en la ruta de Albania?

La ruta de Albania lista actualmente más de 1.500 servicios. Entre las entradas populares de la instantánea en vivo están WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, Signal, Microsoft & Outlook, ChatGPT (OpenAI), Uber, LinkedIn y Discord.

El inventario cambia durante el día, por eso la disponibilidad sale de la API y no de una lista estática. Condiciona cada prueba a una consulta de precio para al y márcala como omitida, no como fallida, cuando la ruta esté cerrada. Así el ruido del enrutamiento de OTP no contamina tus resultados reales de regresión.

¿Puede un compañero no técnico pedir un número +355?

Sí. El panel cubre el mismo flujo sin escribir código:

1. Regístrate con tu correo y un código de correo de 6 dígitos o con Google, y activa la autenticación en dos pasos TOTP.
2. Añade fondos al monedero con tarjeta o con USDT/USDC.
3. Elige Albania y el servicio, comprueba el precio mostrado y confirma el pedido.
4. Escribe el número de verificación de Albania en la app; el código aparece en la página de la activación cuando llega el SMS.

Las agencias que gestionan perfiles de clientes y el personal de operaciones que configura cuentas empresariales regionales suelen usar esta vía. Los pedidos hechos aquí y mediante la API comparten un único monedero y la misma regla de reembolso.

¿Qué hago si el SMS albanés no llega?

Una activación permanece abierta 20 minutos. Solo pagas si llega el código; si la ventana se cierra vacía o cancelas antes, el importe completo vuelve a tu monedero por sí solo y el webhook dispara activation.expired o activation.cancelled.

Cuando falta un código:

• Dale tiempo a la ventana antes de reaccionar, porque algunos servicios envían despacio.
• Comprueba si el servicio acepta números virtuales; algunos los rechazan por política.
• Inténtalo de nuevo más tarde, o con otra ruta de servicio si tu prueba lo permite.
• Evita volver a pedir en un bucle rápido. Espera entre intentos para que un script no sature la ruta.

Nuestro artículo sobre cómo reducir las entregas de OTP fallidas recoge más patrones de reintento para rutas de los Balcanes y de otras zonas. Usa estos números solo para tus propios productos y cuentas, respeta las condiciones de cada servicio y ten en cuenta que se aplica la Política de uso aceptable de OTP Route.

¿Hay una línea albanesa de larga duración y cómo funciona la facturación?

No hay un número de larga duración de autoservicio para Albania. Los números virtuales dedicados se venden al instante solo en Estados Unidos y Canadá, desde $1.95/mes, con SMS entrantes, reenvío por webhook, SMS salientes y llamadas desde el navegador. Si necesitas una línea albanesa duradera, escribe a [email protected]; que se pueda gestionar depende de la normativa local y no está garantizado.

La facturación funciona con un único monedero prepago en USD, sin cuota mensual y sin plan que elegir. Recarga con tarjeta o con USDT/USDC, y cada recarga llega con una factura en PDF por correo. Las tarifas en vivo están en la página de precios. Para trabajo de integración, pide que se cambie una cuenta de desarrollo a sandbox, que devuelve números y códigos simulados para poder probar el pipeline sin gastar fondos del monedero.

Preguntas frecuentes

¿Puedo probar el flujo de registro albanés de mi app sin una SIM local?

Sí. Pide un número de OTP Gateway con el país al, introdúcelo en tu pantalla de registro y lee el código en el panel o desde tu webhook. No intervienen SIM ni contrato con un operador local.

¿Cuánto cuesta un código de verificación albanés?

Los códigos empiezan desde $0.20, y el precio exacto de un servicio lo devuelve GET /api/v1/prices antes de que pidas. Si no llega nada dentro de la ventana de 20 minutos, el cargo vuelve a tu monedero.

¿Debo guardar los números albaneses con el 0 inicial?

No. Guárdalos en E.164, es decir, +355 seguido del número nacional sin el 0 troncal, y vuelve a añadir el 0 solo para mostrarlo en formato local.

¿Se puede reutilizar el mismo número +355 para un inicio de sesión posterior?

Un número de OTP Gateway sirve para un solo código de verificación. Para cuentas que deben seguir iniciando sesión, usa un número dedicado en EE. UU. o Canadá, o consulta a soporte sobre Albania.

¿OTP Route tiene un sandbox para pruebas de integración con Albania?

El modo sandbox puede activarse a petición para una cuenta de desarrollo. Devuelve números y códigos simulados, así que las ejecuciones de CI recorren el flujo completo sin tocar los fondos del monedero.

¿Por qué la app rechazó mi número albanés?

Algunos servicios rechazan los números virtuales. Cancela la activación o deja que expire para obtener un reembolso automático, y luego prueba en otro momento o por otra ruta.

¿Qué id de API uso para Albania?

Usa al como valor de país en las consultas de precio y en las solicitudes de activación, y toma el id del servicio de GET /api/v1/services.

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.