Lista de verificación previa para números de verificación de las Islas Caimán

Lista previa: ¿qué debe estar listo antes de pedir un número +1 345?

Repasa esta lista una vez y la primera activación en Caimán suele transcurrir sin sobresaltos:

• Cuenta y seguridad. Regístrate con una dirección de correo y un código de 6 dígitos por correo (o con el inicio de sesión de Google), y activa la verificación en dos pasos con TOTP para quien pueda gastar del monedero.
• Monedero con saldo. Recarga el monedero prepago en USD con tarjeta o con USDT/USDC. No hay plan que elegir ni cuota mensual.
• Clave de API. Crea una clave en la consola de desarrolladores; empieza por or_live_ y va en un encabezado Bearer. Una cuenta puede tener hasta 10 claves.
• Endpoint de webhook. Registra una URL y guarda su secreto donde tu manejador pueda leerlo. El máximo es de cinco endpoints por cuenta.
• Análisis de teléfonos configurado. Asegúrate de que tu biblioteca de números asocia el código de área 345 con las Islas Caimán y no trata por defecto todos los números +1 como de Estados Unidos.
• Sandbox, si quieres un ensayo. Pide a soporte que pase una cuenta de desarrollo al modo sandbox para que los números y códigos simulados ejerciten tu integración sin tocar los fondos del monedero.

La referencia de la API enumera todos los campos que verás en las respuestas.

¿Por qué un número de Caimán rompe el código que supone que +1 significa Estados Unidos?

Las Islas Caimán forman parte del Plan de Numeración de América del Norte, por lo que comparten el código de país 1 con EE. UU., Canadá y una larga lista de territorios caribeños. Lo que identifica una línea de Caimán es el código de área 345. Un número completo tiene diez dígitos tras el código de país, se escribe localmente como (345) NXX-XXXX y se guarda en E.164 como +1345 seguido de siete dígitos.

Tres consecuencias prácticas para los ingenieros:

• La detección de región debe fijarse en el código de área. Un formulario de registro que deduce el país solo por el prefijo +1 etiquetará a un cliente de Caimán como estadounidense y puede elegir mal la zona horaria, la moneda o el texto de consentimiento.
• En el NANP el 1 inicial hace también de dígito troncal de larga distancia, por lo que los usuarios a veces escriben 1 345... o solo 345.... Normaliza las tres formas a la cadena E.164 antes de guardar.
• Guarda los números sin espacios, guiones ni paréntesis, y dales formato solo al mostrarlos.

El inglés es el idioma oficial, por lo que los códigos de este mercado suelen llegar en inglés. La redacción exacta, sin embargo, la fija el servicio que envía el mensaje, no la ruta.

¿Qué servicios pueden enviar códigos a un número de verificación de las Islas Caimán?

La instantánea en vivo del país ky incluye actualmente WhatsApp, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Amazon, Airbnb, Uber, Signal, Discord, ChatGPT (OpenAI), Netflix y eBay. Contando la cola larga, la ruta cubre más de 600 servicios, y la lista se mueve durante el día, por eso la disponibilidad siempre se lee de la API y no se fija en el código.

Los equipos suelen necesitar un número +1 345 para pruebas porque las islas son un importante centro financiero extraterritorial y un destino turístico muy activo. Administradores de fondos, aseguradoras, plataformas de viajes y empresas inmobiliarias incorporan clientes locales, y sus equipos de producto quieren ver cómo se comporta el registro tal como lo viviría un residente de Caimán. Las notas sobre incorporación fintech tratan ese patrón con más detalle.

Paso a paso: ¿cómo es la secuencia de llamadas de la API OTP de las Islas Caimán?

Todas las llamadas van a https://otproute.com/api/v1 con tu clave Bearer, dentro de un límite de 300 solicitudes por minuto.

1. Llama una vez a GET /api/v1/services y guarda en caché los ids de servicio que necesita tu batería de pruebas.
2. Llama a GET /api/v1/prices?country=ky&service=<id> para leer el precio en vivo y confirmar que el par está disponible ahora.
3. Envía POST /api/v1/activations con un cuerpo como {"service": "<id>", "country": "ky"}. La respuesta incluye el id de activación y el número +1 345.
4. Introduce ese número en la aplicación bajo prueba y dispara su paso de SMS.
5. Espera activation.sms_received en tu webhook. Revisa primero el encabezado X-OTPRoute-Signature: calcula HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint, compáralo con v1 y rechaza las marcas de tiempo antiguas.
6. Sin webhook, sondea GET /api/v1/activations/{id} a un intervalo moderado hasta que aparezca el código o se cierre la ventana.
7. Si la prueba se interrumpe, llama a POST /api/v1/activations/{id}/cancel para que la retención vuelva al monedero.

La guía de webhooks con HMAC recorre la verificación de firmas línea por línea.

Paso a paso para quienes prefieren el panel

El personal de soporte y los gestores de cuentas no necesitan tocar la API:

1. Abre la página del OTP Gateway en el panel.
2. Elige las Islas Caimán como país y después el servicio que vas a verificar.
3. Revisa el precio mostrado antes de pedir y confirma.
4. Copia el número en la aplicación, solicita el código y deja abierta la página de la activación; el SMS aparece allí cuando llega.

La ventana de 20 minutos y el reembolso se aplican exactamente igual que a través de la API.

Resolución de problemas: ¿y si no llega ningún código al número +1 345?

No se cobra nada por una activación silenciosa. Si no llega ningún SMS antes de que pasen los 20 minutos, o cancelas, el importe completo vuelve al monedero por sí solo. Antes de pedir de nuevo:

• Deja correr la ventana. El tiempo de entrega depende del servicio y de la ruta, así que un código lento no es necesariamente un código fallido.
• Revisa la política del servicio. Algunos servicios rechazan por completo los números virtuales, que es justo la situación para la que existe el reembolso.
• Reintenta más tarde o cambia de ruta. El inventario cambia durante el día; un segundo intento una hora después, o un país caribeño vecino, puede comportarse de otra manera.
• Evita los bucles cerrados. Un script que cancela y vuelve a pedir cada pocos segundos agota tu límite de solicitudes y rara vez ayuda.

El manual de entregas fallidas incluye más diagnósticos. Usa cada número solo para tu propio producto o tus propias cuentas de empresa, sigue los términos de cada servicio y recuerda que se aplica la Política de Uso Aceptable de OTP Route.

¿Puedo conservar una línea de Caimán a largo plazo y cómo se gestiona la facturación?

No existe un número de largo plazo de autoservicio para las Islas Caimán. Compartir el código de país +1 no cambia eso: los Números Dedicados son un producto solo de Estados Unidos y Canadá, desde $1.95/mes, con SMS entrantes, SMS salientes y llamadas desde el navegador. Si tu equipo necesita una línea 345 permanente, escribe a [email protected]; la disponibilidad depende de la normativa local y no está prometida.

Todo lo demás funciona con un único monedero prepago en USD. Las recargas con tarjeta o USDT/USDC generan cada una una factura en PDF por correo, y la página de precios explica el modelo de pago por uso.

Preguntas frecuentes

¿Puedo probar el registro de mi aplicación en las Islas Caimán sin una SIM local?

Sí. Pide un número +1 345 en el OTP Gateway, introdúcelo en tu aplicación y lee el código en el panel o a través de la API. Pagas desde $0.20 por código y solo cuando el código llega.

¿Qué id de país usa la API para las Islas Caimán?

El id es ky. Pásalo como valor de country al llamar a GET /api/v1/prices o POST /api/v1/activations.

¿Cómo debo guardar un número de teléfono de Caimán en mi base de datos?

Guárdalo en formato E.164: +1345 seguido del número de abonado de siete dígitos, sin espacios ni signos de puntuación. Detecta el territorio por el código de área 345, no por el prefijo +1.

¿Un número +1 345 cuenta como número de EE. UU. para los Números Dedicados?

No. Los Números Dedicados se venden solo para Estados Unidos y Canadá, así que una línea de Caimán solo está disponible como activación de un solo código del OTP Gateway.

¿Qué pasa con mi dinero si el SMS nunca aparece?

La activación permanece abierta durante 20 minutos. Si en ese tiempo no llega ningún código, o cancelas antes, el importe completo se devuelve automáticamente a tu monedero.

¿Puedo ejecutar pruebas OTP de Caimán en CI sin gastar saldo del monedero?

Pide a soporte que pase una cuenta de desarrollo a sandbox. Devuelve números y códigos simulados, de modo que tu pipeline puede ejercitar el flujo completo de activación y webhook sin coste.

¿Cuántos servicios de Caimán cubre OTP Route?

Más de 600 en la última instantánea. Como el inventario cambia durante el día, consulta GET /api/v1/services y el endpoint de precios para conocer la disponibilidad en vivo.

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.