Códigos de verificación de Mónaco (+377) para equipos de producto y QA

¿Por qué los equipos prueban con números monegascos?

Mónaco es diminuto, pero pesa más de lo que indica su tamaño en negocios de banca privada, hostelería, servicios de yates y eventos internacionales. Los clientes de allí esperan que un producto acepte un número +377 sin quejas, y sorprende cuántos formularios siguen suponiendo que cualquiera cercano a la Riviera tiene una línea francesa +33.

Esa suposición provoca tickets de soporte reales. Muchas personas que trabajan en Mónaco viven al otro lado de la frontera, en Francia, y llevan números franceses, mientras que los residentes tienen números monegascos, de modo que una misma base de clientes mezcla ambos prefijos. Un número de verificación de Mónaco, pedido como número +377 para pruebas, permite a los ingenieros de QA demostrar que el selector de país, las reglas de validación y las plantillas de SMS tratan el principado como un país propio y no como un suburbio francés.

¿Cómo debe un formulario guardar y validar los números +377?

Mónaco tiene su propio código de llamada, distinto del de Francia, y sus números nacionales son cortos en comparación con la mayor parte de Europa. En formato internacional no hay prefijo troncal: el número es +377 seguido directamente de los dígitos del abonado.

Algunas reglas prácticas para ingenieros:

• Guarda los números en E.164 (+377…) y presenta una agrupación amigable solo al mostrarlos.
• Los usuarios acostumbrados a la marcación francesa a veces escriben un 0 inicial por costumbre. Quítalo durante la normalización en lugar de hacer fallar la validación.
• No deduzcas el país a partir de un prefijo +33 y una dirección postal de Mónaco; mantén el país del teléfono y el país de facturación como campos independientes.
• Usa una biblioteca de números de teléfono mantenida en lugar de una comprobación de longitud escrita a mano, ya que las longitudes francesas fijadas en el código rechazan números monegascos válidos.

El francés es el idioma oficial, así que los textos de verificación suelen llegar en francés, aunque el italiano y el inglés se usan mucho en la zona y muchas apps envían inglés cuando la cuenta está configurada así. Prueba ambos si tu onboarding está localizado.

¿Qué servicios puede verificar una ruta de Mónaco?

Ahora mismo hay más de 1,300 servicios disponibles en la ruta de Mónaco. Entre los populares en la instantánea de hoy están Instagram, Airbnb, Telegram, Claude, WhatsApp, Facebook, Google (Gmail & YouTube), Uber, Netflix, eBay, LinkedIn y X (Twitter).

La cobertura no es fija. Los socios operadores rotan la capacidad durante el día, así que un servicio visible por la mañana puede estar en pausa por la tarde. Un buen enrutamiento OTP lee la disponibilidad en el momento del pedido en lugar de depender de una lista en caché, y la API de verificación por SMS lo expone precisamente a través del endpoint de precios.

¿Cómo es la secuencia de la API OTP de Mónaco?

Las solicitudes van a https://otproute.com/api/v1 y se autentican con una clave Bearer que empieza por or_live_, creada en la consola de desarrolladores. El id de país de Mónaco es mc.

1. Obtén GET /api/v1/services y GET /api/v1/countries de vez en cuando para asociar nombres con ids.
2. Antes de cada pedido, llama a GET /api/v1/prices?country=mc&service=<id>. Responde con el precio en vivo y si el par puede atenderse.
3. Crea el pedido con POST /api/v1/activations, por ejemplo {"service": "airbnb", "country": "mc"}. Conserva el id de activación devuelto.
4. Escribe el número +377 en tu app y espera activation.sms_received en tu webhook, o consulta GET /api/v1/activations/{id}.
5. Al terminar, llama a POST /api/v1/activations/{id}/cancel para todo lo que siga pendiente.

Verifica la cabecera X-OTPRoute-Signature de cada webhook recalculando HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint, y rechaza las marcas de tiempo antiguas. Cada cuenta puede registrar 5 endpoints de webhook y enviar hasta 300 solicitudes por minuto, lo que deja margen para ejecuciones paralelas en Mónaco. La guía de integración recorre los mismos pasos con manejo de errores.

¿Hay una forma sin código para el personal de operaciones?

El panel cubre el mismo camino para quien prefiera no tocar una API. Elige Mónaco en el OTP Gateway, selecciona el servicio, revisa el precio que aparece y confirma. El número +377 se muestra en una tarjeta de activación; pégalo en la pantalla de inicio de sesión o de registro y el código aparece en esa tarjeta cuando llega el SMS.

La ventana dura 20 minutos. Si el código no llega a tiempo, o cancelas el pedido, el importe completo se reembolsa al monedero sin necesidad de abrir una solicitud de soporte.

¿Y si un código de Mónaco no llega?

Los mercados pequeños tienen menos rutas, así que aquí importan más la paciencia y un plan alternativo que en los países grandes.

• Dale al pedido la ventana completa antes de cancelar.
• Comprueba si el servicio acepta números virtuales para esa acción; algunos los rechazan de plano.
• Reintenta tras una pausa en lugar de repetir el pedido en bucle, lo que puede activar límites de frecuencia por parte del servicio.
• Si la prueba solo necesita un número de la zona de la Riviera, la ruta de Francia o la ruta de Italia pueden tener más capacidad en ese momento.

Mantén cada prueba dentro de los términos del servicio. OTP Route sirve para verificar tus propios productos y cuentas empresariales legítimas, y se aplica su Política de Uso Aceptable.

¿Se puede conservar un número de Mónaco a largo plazo y cómo se gestiona la facturación?

No existe una línea +377 de largo plazo con autoservicio. Los Números Virtuales Dedicados, que conservas mientras se renuevan y que admiten SMS entrantes, SMS salientes y llamadas desde el navegador, son un producto de Estados Unidos y Canadá desde $1.95/month. Para una línea monegasca, escribe a [email protected]; el equipo puede decirte si la normativa local permite algo, sin ninguna promesa.

Los pedidos de Mónaco se cargan al mismo monedero prepago en USD que todo lo demás, sin cuota mensual ni plan que elegir. Recárgalo con tarjeta o USDT/USDC, y espera una factura en PDF por correo por cada recarga. Durante el trabajo de integración, una cuenta de desarrollo puede pasar a sandbox a petición, devolviendo números y códigos simulados para que pruebes de extremo a extremo sin coste. Los detalles están en la página de precios.

Preguntas frecuentes

¿Es un número de teléfono de Mónaco igual que uno francés?

No. Mónaco usa su propio código +377, así que la lógica de validación debe tratarlo por separado del +33 de Francia.

¿Cuál es el id de país de Mónaco en la API de OTP Route?

Usa mc en la consulta de precios y en el cuerpo de la solicitud de activación.

¿Puedo conseguir un número +377 para probar un lanzamiento europeo?

Sí, el OTP Gateway emite números +377 de un solo uso para verificaciones únicas, pedidos desde el panel o la API.

¿Cuánto tiempo tengo para recibir el código de Mónaco?

Cada activación permanece abierta 20 minutos; si no llega nada, el cargo se reembolsa automáticamente.

¿Los números monegascos incluyen un prefijo troncal?

No en formato internacional. Quita cualquier 0 inicial que escriba un usuario y guarda el número como +377 más los dígitos del abonado.

¿En qué idioma llegará un SMS de verificación de un servicio de Mónaco?

Normalmente en francés, pero depende de la app y del idioma de la cuenta, así que son posibles textos en inglés o italiano.

¿Puedo ejecutar mis pruebas de Mónaco sin gastar fondos reales?

Pide el modo sandbox en una cuenta de desarrollo. Devuelve números y códigos simulados para pruebas de integració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.