Códigos de verificación SMS de Jamaica: lista de control, pasos y soluciones

¿Qué debo confirmar antes de la primera activación en Jamaica?

Jamaica forma parte del Plan de Numeración de Norteamérica, así que algunas comprobaciones son distintas a las de la mayoría de los países:

• Tu validador acepta números +1 que no son de EE. UU. ni de Canadá. Muchos formularios de registro asumen en silencio que todo número +1 es estadounidense.
• Tu selector de países lista a Jamaica por separado, en vez de tratar +1 como una única región.
• Existe una clave de API or_live_ en la consola para desarrolladores, y hay un endpoint de webhook desplegado con su secreto, o tu entorno de pruebas está configurado para hacer polling.
• El monedero tiene fondos, o se ha activado el modo sandbox para una prueba en seco.
• Conoces el id del servicio por GET /api/v1/services; el id de país de Jamaica es jm.

Equivocarte en las dos primeras produce fallos que parecen problemas de enrutamiento pero que viven por completo en tu propio código.

¿Por qué un número jamaiquino +1 necesita un tratamiento especial?

Los números de Jamaica usan los códigos de área 876 y el más reciente 658, seguidos de un número de abonado de siete dígitos, así que la forma E.164 completa es +1 más diez dígitos. A nivel nacional la gente marca un 1 inicial para larga distancia, que debe eliminarse antes de guardar.

Lo importante para los ingenieros es que +1 por sí solo no dice nada del país. La detección de región tiene que mirar el código de área, y cualquier lógica que elija una moneda, una zona horaria o una plantilla de SMS a partir del prefijo de marcación necesita el mismo cuidado. Guarda la cadena E.164 canónica, mantén la región detectada en un campo aparte y prueba entradas tanto con 876 como con 658.

El inglés es el idioma oficial y los textos de verificación casi siempre llegan en inglés, mientras que el habla cotidiana suele usar el patois jamaiquino. Los equipos hacen pruebas aquí para lanzamientos en el Caribe, para flujos de remesas y fintech que atienden a la diáspora en EE. UU., Reino Unido y Canadá, y para productos de turismo y hostelería. El artículo sobre enrutamiento de OTP por país explica cómo elegir rutas por mercado.

¿Cuáles son los pasos de la API de verificación por SMS de Jamaica?

1. Consulta los precios en vivo con GET /api/v1/prices?country=jm&service=<id> sobre la URL base https://otproute.com/api/v1.
2. Haz el pedido: POST /api/v1/activations con el cuerpo {"service": "<id>", "country": "jm"}. Anota el id de activación y el número.
3. Introduce el número en la app que estás probando.
4. Recibe el código mediante el evento activation.sms_received en tu webhook, o haciendo polling a GET /api/v1/activations/{id}.
5. Abandona un intento jamaiquino antes de tiempo enviando POST /api/v1/activations/{id}/cancel, lo que libera la retención.

Antes de actuar sobre cualquier evento, recalcula el HMAC-SHA256 de "<t>.<raw body>" con el secreto de tu endpoint, compáralo con el valor v1 de X-OTPRoute-Signature y rechaza las marcas de tiempo demasiado antiguas. Gestiona también activation.expired y activation.cancelled, usando el id de activación como clave, para que los reintentos nunca se procesen dos veces. Para planificar la capacidad, una sola cuenta puede tener 10 claves y 5 endpoints de webhook, con un tope de 300 solicitudes por minuto entre todos.

¿Qué apps pueden recibir códigos en una ruta jamaiquina?

Jamaica lista actualmente más de 900 servicios. Entre los más usados están WhatsApp, Telegram, Google (Gmail y YouTube), Facebook, Instagram, TikTok, X (Twitter), Snapchat, Amazon, Uber, Netflix, Airbnb y ChatGPT (OpenAI).

La disponibilidad de cada servicio varía a lo largo del día, así que lee el endpoint de precios al inicio de cada ejecución en lugar de fijar una lista en el código.

¿Cómo sigue la misma lista de control quien no programa, desde el panel?

Crea una cuenta en /signup con un código por correo o con Google, activa TOTP y recarga fondos. Después abre el OTP Gateway, elige el servicio, elige Jamaica y confirma el precio en vivo. Pega el número en la app y el código aparecerá en el panel en cuanto llegue el mensaje. El personal de soporte suele usar esta vía para reproducir un problema de registro de un cliente con un número jamaiquino.

Solución de problemas: el código jamaiquino llega tarde, no llega o es rechazado

• ¿Rechazado al introducirlo? Revisa primero tu propio formulario; un validador solo para EE. UU. es un culpable frecuente. Si es la app de terceros la que rechaza el número, puede que no acepte números virtuales.
• ¿Todavía nada? Deja la activación abierta durante sus 20 minutos en lugar de cancelar y volver a pedir.
• ¿Sigue sin llegar? Inténtalo más tarde o con otra ruta de servicio. Evita martillear el mismo pedido en un bucle.

Cuando ningún SMS llega al número antes de que termine la ventana, el cargo completo se devuelve automáticamente al monedero. La guía sobre cómo reducir las entregas fallidas de OTP tiene una lista más larga.

¿Las líneas dedicadas, el monedero y el sandbox aplican a Jamaica?

Compartir el código +1 no hace que Jamaica forme parte del producto dedicado. Los Números Virtuales Dedicados se venden solo para Estados Unidos y Canadá, desde $1.95/mes, y no existe un número jamaiquino de largo plazo autogestionado. Si necesitas uno, escribe a [email protected] para preguntar; las normas locales deciden y no se promete nada.

Todo lo demás funciona igual que en cualquier otro lugar: un monedero prepago en USD, sin cuota mensual, recargas con tarjeta o USDT/USDC y una factura en PDF por correo para cada una. El modo sandbox, disponible si lo solicitas, devuelve números y códigos simulados para pruebas de integración. Consulta /pricing para ver cómo funcionan los cargos.

Preguntas frecuentes

¿Puedo probar la verificación telefónica jamaiquina de mi app sin estar en Kingston?

Sí. Pide un número +1 876 o +1 658 para tu servicio a través de OTP Route y lee el código en el panel o en la API, esté donde esté tu equipo.

¿Qué id de país envío para Jamaica?

Envía jm. El prefijo de marcación es +1, pero la API identifica el país por ese id.

¿Un número jamaiquino cuenta como número de EE. UU.?

No. Comparte el código +1, pero es un país distinto con sus propios códigos de área, y muchas apps lo tratan como Jamaica.

¿Qué pasa con mi dinero si el código jamaiquino no llega?

Si no llega ningún SMS en 20 minutos, o cancelas, el importe completo vuelve al monedero.

¿Puedo comprar un número jamaiquino de largo plazo en OTP Route?

No de forma autogestionada. Los Números Dedicados de largo plazo cubren solo EE. UU. y Canadá; escribe a soporte para preguntar por Jamaica.

¿Hay forma de probar el flujo de webhooks sin pagar?

Pide el modo sandbox en una cuenta de desarrollo. Devuelve números y códigos simulados, y el artículo sobre captura de OTP mediante webhooks explica la parte del manejador.

¿Qué usos de un número +1 de Jamaica para pruebas están permitidos?

Probar tu propio producto, automatizar QA y operar cuentas de negocio legítimas. La ruta del Caribe está sujeta a los términos de cada app y a la Política de Uso Aceptable de OTP Route.

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.