Lista de control previa para recibir códigos SMS de Curazao (+599)

¿Qué debe figurar en la lista de control antes de pedir un número +599?

Los mercados insulares premian un poco de preparación, porque la disponibilidad de las rutas cambia durante el día y una prueba apresurada hace perder tiempo. Marca estos puntos antes de la primera solicitud:

• Una clave de API de la consola de desarrolladores. Las claves empiezan por or_live_; una cuenta puede tener hasta 10, así que dale a CI y a staging las suyas.
• Un monedero en USD con fondos, o una cuenta de desarrollo pasada a sandbox bajo petición si solo quieres ejercitar la integración.
• Los ids correctos. Curazao es cw en la API; el id del servicio sale de GET /api/v1/services.
• Un endpoint de webhook con su secreto guardado, o un bucle de consulta con un intervalo razonable. Se permiten hasta 5 endpoints por cuenta.
• Una regla de almacenamiento para los números +599 (se explica más abajo), para que los datos de prueba coincidan con los de producción.
• Un plan para el caso vacío: qué hace tu prueba cuando la ventana caduca sin código.

¿Qué servicios cubre la ruta del número de verificación de Curazao?

La captura en vivo de Curazao lista más de 400 servicios. Entre los populares están Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal, Netflix, Uber y Airbnb. Los nombres de viajes y mensajería son los que los equipos de Curazao suelen buscar primero, ya que los productos de hostelería y los orientados a visitantes generan muchos de los registros digitales de la isla.

Toma esta lista como punto de partida y no como una promesa. El inventario cambia a lo largo del día, y por eso la API devuelve la disponibilidad con cada consulta de precio.

Paso a paso: cómo llamar a la API OTP de Curazao

Cada llamada va a https://otproute.com/api/v1 con tu clave Bearer, dentro de un tope de 300 solicitudes por minuto.

1. Lee GET /api/v1/prices?country=cw&service=<id> para confirmar que la ruta está abierta y ver el precio actual de esa combinación.
2. Crea el pedido con POST /api/v1/activations, enviando {"service": "telegram", "country": "cw"} o el id de servicio que necesites. La respuesta trae un id de activación y el número +599.
3. Introduce ese número en la pantalla de registro o de acceso que estás probando.
4. Espera activation.sms_received en tu webhook, o consulta GET /api/v1/activations/{id} a un intervalo tranquilo.
5. Si la prueba se abandona, llama a POST /api/v1/activations/{id}/cancel para que el monedero reciba el abono de inmediato.

Antes de confiar en cualquier webhook, comprueba la cabecera X-OTPRoute-Signature: calcula HMAC-SHA256 sobre "<t>.<raw body>" con el secreto del endpoint y rechaza las marcas de tiempo antiguas. La guía de firma de webhooks lo explica con más detalle.

¿Cómo se debe guardar y normalizar un número +599?

Curazao comparte el código de país +599 con Bonaire, San Eustaquio y Saba, y los números de abonado de Curazao siguen a ese código con un 9. Ese 9 inicial forma parte del número, no es un prefijo troncal, así que un normalizador que lo elimine corromperá el registro. Guarda la cadena E.164 completa (+5999 seguido de los dígitos restantes) sin espacios, y da formato solo al mostrarla.

También conviene comprobar que tu widget de entrada de teléfono lista Curazao como entrada propia en lugar de agruparlo en una opción genérica de Antillas Neerlandesas, como todavía hacen las bibliotecas antiguas.

Sobre el idioma: el papiamento, el neerlandés y el inglés son oficiales, y la mayoría de los servicios globales envían los códigos en inglés o siguen el idioma configurado en la cuenta. Si tu producto se localiza al neerlandés o al papiamento, haz al menos una pasada por idioma para ver la plantilla real y no una de respaldo. Los equipos suelen hacer pruebas aquí al lanzar en el Caribe neerlandés, al atender a visitantes que reservan desde el extranjero o al gestionar operaciones regionales desde la isla.

¿Cuál es el camino por el panel para quien no escribe código?

Los agentes de soporte y los responsables de producto pueden hacer lo mismo sin ningún script:

1. Crea una cuenta con correo y un código de 6 dígitos, o con el acceso de Google, y activa la autenticación en dos pasos TOTP.
2. Recarga el monedero.
3. Abre el OTP Gateway, elige el servicio y luego Curazao; el precio aparece antes de confirmar.
4. Copia el número +599 en la app y observa la tarjeta de la activación hasta que aparezca el código.

Se aplican la misma ventana de 20 minutos y la misma regla de reembolso que con la API.

Solución de problemas: el código de Curazao no apareció

Una activación silenciosa es normal de vez en cuando, y no cuesta nada porque el importe vuelve al monedero cuando la ventana se cierra o cancelas.

• Deja correr la ventana. Algunos servicios reenvían despacio; cancelar en el minuto dos descarta un código que aún podría llegar.
• Comprueba la postura del servicio de destino sobre los números virtuales. Algunos los rechazan, y por eso existe el reembolso.
• Reintenta más tarde, o prueba otra ruta de país si la prueba no depende específicamente de un número de Curazao.
• Evita volver a pedir en bucle rápido. Espacia los intentos para no apilar activaciones paralelas en una sola prueba.

La página de solución de pruebas de QA muestra cómo los equipos incorporan estos reintentos en suites automatizadas.

Líneas de larga duración, monedero y facturación para proyectos de Curazao

No hay un número de larga duración en autoservicio para Curazao. Si necesitas una línea que conserves durante meses, escribe a [email protected] y el equipo comprobará qué permite la normativa local; no se promete nada. Las líneas dedicadas son un producto de EE. UU. y Canadá, desde $1.95/month, descrito en la página de números virtuales.

Las activaciones de Curazao salen de un único monedero prepago en USD, sin cuota mensual y sin plan que elegir. Funcionan tanto los pagos con tarjeta como USDT/USDC para recargar, y cada recarga genera una factura en PDF por correo para la contabilidad de tu proyecto en Curazao. Las tarifas vigentes están en la página de precios. Usa OTP Route solo para tus propios productos y cuentas legítimas, respeta los términos de cada servicio y ten en cuenta que se aplica la Política de Uso Aceptable de OTP Route.

Preguntas frecuentes

¿Puedo probar un registro de Curazao sin comprar una SIM local?

Sí. Pide un número +599 en el OTP Gateway para el servicio que pruebas y lee el código en el panel o por la API, sin SIM ni teléfono en la isla.

¿Qué id de país usa OTP Route para Curazao?

Curazao es cw. Combina cw con el id de servicio de GET /api/v1/services en cada consulta de precio y pedido.

¿El 9 después de +599 es un prefijo troncal que debo quitar?

No. En Curazao el 9 forma parte del número de abonado, así que consérvalo en el valor E.164 guardado.

¿Me cobran cuando una activación de Curazao caduca sin código?

No. Si no llega ningún SMS en 20 minutos, o cancelas antes, el importe completo vuelve automáticamente a tu monedero.

¿Puedo conservar un número de Curazao para inicios de sesión repetidos el mes que viene?

No en autoservicio. Los números dedicados de larga duración se venden solo para EE. UU. y Canadá; para Curazao puedes escribir a soporte para consultarlo, sin ninguna promesa de disponibilidad.

¿Cómo puedo montar la integración antes de gastar fondos del monedero?

Pide a soporte el modo sandbox para una cuenta de desarrollo. Devuelve números y códigos simulados para que se pueda ejercitar de extremo a extremo todo el recorrido de la API y los webhooks.

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.