Números de verificación de Haití (+509) para equipos de producto y QA

¿Por qué probaría un equipo de producto un número de teléfono haitiano?

Haití es un mercado donde el número de teléfono suele cumplir más funciones que una dirección de correo. Las apps de mensajería llevan conversaciones familiares, de negocios y de comunidad, y muchos productos para clientes haitianos están pensados también para la numerosa diáspora en Estados Unidos, Canadá y Francia. Por eso, los equipos de remesas, dinero móvil, marketplaces y mensajería acaban necesitando demostrar que un número +509 puede registrarse, iniciar sesión y recuperar una cuenta.

El idioma es la otra razón. El criollo haitiano y el francés son oficiales, así que el QA de localización implica comprobar que tus pantallas, mensajes de error y plantillas de SMS se leen bien en cada uno, y que un usuario que cambia de idioma a mitad del flujo sigue recibiendo un código que puede entender. Probar con un número de verificación real de Haití es la forma más directa de ver ese recorrido como lo vería un cliente. Para una guía más amplia, consulta nuestra página sobre verificación en apps móviles.

¿Cómo se formatean y almacenan los números +509?

Los números haitianos tienen ocho dígitos después del código de país +509. La marcación nacional no usa prefijo troncal, lo que significa que la forma local son simplemente esos ocho dígitos y la internacional añade +509 delante.

Guarda el valor canónico en E.164 (+509 seguido de los ocho dígitos) y elimina espacios, guiones y un 00509 inicial en la entrada. Ten en cuenta también el comportamiento de la diáspora: un cliente haitiano que vive en el extranjero puede registrarse con un número de EE. UU. o Canadá y añadir más tarde una línea +509, así que tu selector de país y tus comprobaciones de duplicados deben tratar el código de país como parte de la identidad y no como un adorno.

El SMS en sí lo redacta el servicio remitente. Según la app y el idioma de la cuenta, un código enviado a un número haitiano puede llegar en francés, inglés u otro idioma que el servicio admita, así que asegúrate de que tu analizador extraiga los dígitos sin importar las palabras que los rodean.

¿Qué servicios pueden enviar un código a un número de verificación de Haití?

La ruta +509 ofrece actualmente más de 1,000 servicios. La instantánea en directo incluye WhatsApp, Facebook, Instagram, Telegram, Google (Gmail y YouTube), Microsoft y Outlook, TikTok, X (Twitter), Snapchat, Signal, Viber, Amazon, Netflix y eBay.

Interpreta esos nombres como ejemplos de lo que suelen gestionar los números +509, no como un menú fijo. El inventario cambia a lo largo del día, así que la API y el panel muestran lo que está abierto en el momento en que preguntas. Algunos servicios también rechazan los números virtuales, y el reembolso automático existe precisamente para ese caso. Los nombres de los servicios pertenecen a sus propietarios; no existe afiliación entre ellos y este producto.

Cómo llamar a la API OTP de Haití con el id de país `ht`

Los desarrolladores acceden al mismo inventario por REST. Autentícate con una clave Bearer de la consola de desarrolladores (prefijo or_live_) contra https://otproute.com/api/v1, y luego:

1. Lista los servicios con GET /api/v1/services y, para confirmar la cobertura, los países con GET /api/v1/countries.
2. Lee el precio en directo con GET /api/v1/prices?country=ht&service=<id>.
3. Haz el pedido con POST /api/v1/activations, enviando {"service": "<id>", "country": "ht"}.
4. Recoge el código de un webhook activation.sms_received o haciendo polling a GET /api/v1/activations/{id}.
5. Libera el número antes con POST /api/v1/activations/{id}/cancel si tu prueba termina de otra manera.

Cada webhook lleva X-OTPRoute-Signature: t=<unix>,v1=<hex>. Verifica el HMAC-SHA256 sobre la marca de tiempo y el cuerpo sin procesar con el secreto de tu endpoint, descarta los eventos con marcas de tiempo antiguas y haz el manejador idempotente respecto al id de la activación. La guía de integración de la API muestra este flujo de enrutamiento OTP con más detalle. Planifica tus scripts en torno a 300 solicitudes por minuto por cuenta.

Cómo obtener un código +509 desde el panel

El personal de soporte y operaciones puede prescindir por completo de la API. Abre el OTP Gateway en tu panel, elige Haití y el servicio, y mira el precio que se muestra antes de pedir. Cuando confirmes, recibes un número +509 para pruebas; pégalo en la app, solicita el SMS y vigila la tarjeta del pedido para ver el código. El número pertenece a esa única verificación y se cierra cuando termina su ventana de 20 minutos.

¿Aún sin código? Solución de problemas de la ruta de Haití

El silencio en un pedido +509 suele tener unas pocas causas corrientes:

• El servicio aún está enviando. Dale toda la ventana antes de dar por hecho el fallo.
• El servicio rechaza los números virtuales. Si un segundo intento más tarde también queda en silencio, elige otra forma de probar ese flujo concreto.
• La ruta está ocupada. Inténtalo de nuevo tras una pausa, o elige otra ruta para el mismo servicio, en lugar de lanzar pedidos nuevos uno tras otro.
• Tu webhook perdió el evento. Haz polling a la activación para ver si el código ya está allí.

Si la ventana se cierra vacía o cancelas, el importe completo vuelve al monedero automáticamente, así que un intento fallido no cuesta nada. Hay más tácticas reunidas en cómo reducir las entregas fallidas de OTP.

Líneas de largo plazo, monedero y sandbox para trabajar con Haití

OTP Route no vende números haitianos de largo plazo de autoservicio. Los Números Virtuales Dedicados, que conservas mientras se renuevan, son un producto de EE. UU. y Canadá desde $1.95/mes, y pueden ser un buen complemento para líneas de soporte orientadas a la diáspora en el lado norteamericano. Si necesitas específicamente una línea +509 de largo plazo, escribe a [email protected]; el equipo lo estudiará, pero la normativa local decide y no se promete nada.

Los pagos se hacen con un único monedero prepago en USD: pago por uso, sin suscripción, recargas con tarjeta o USDT/USDC, y una factura en PDF por cada recarga. Pide el modo sandbox para una cuenta de desarrollo y ensaya el flujo completo de la API de verificación por SMS con códigos simulados. Usa números haitianos solo para tus propios productos y cuentas de empresa legítimas, respeta los términos de cada servicio y mantente dentro de la Política de Uso Aceptable. Regístrate cuando estés listo para hacer el primer pedido.

Preguntas frecuentes

¿Puedo verificar el flujo de registro de mi app en Haití sin una tarjeta SIM haitiana?

Sí. Pide un número +509 en el OTP Gateway de OTP Route, dispara el SMS de tu app y lee el código en el panel o por webhook.

¿Qué id de país usa la API para Haití?

El id es ht. Combínalo con un id de servicio, por ejemplo POST /api/v1/activations con {"service": "telegram", "country": "ht"}.

¿Cuántos servicios funcionan con un número de verificación de Haití?

Más de 1,000 en el momento de la última instantánea. La lista exacta cambia a lo largo del día, así que consulta GET /api/v1/prices o el panel antes de pedir.

¿Pago si el código +509 nunca llega?

No. Si la ventana de 20 minutos pasa sin ningún SMS, o cancelas antes, el importe completo vuelve a tu monedero automáticamente.

¿Llegarán los códigos en criollo haitiano?

Depende totalmente del servicio remitente y del idioma de la cuenta. Diseña tus pruebas para extraer los dígitos tanto si el mensaje está en francés, en inglés o en otro idioma.

¿Puedo conseguir un número haitiano de largo plazo para un servicio de atención?

No como producto de autoservicio. OTP Route ofrece líneas dedicadas en Estados Unidos y Canadá; para Haití, escribe a [email protected] para preguntar por las opciones.

¿Qué métodos de pago puedo usar para recargar?

Tarjeta y las stablecoins USDT o USDC, acreditadas en un monedero prepago en USD. No hay cuota mensual ni plan que elegir.

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.