Números de verificación de la Guayana Francesa (+594) para desarrolladores y QA

¿Un código o un número que conservas? Qué admite la Guayana Francesa

Antes de escribir código, decide qué producto necesita la tarea.

• OTP Gateway sirve para verificaciones puntuales: comprobar que tu flujo de registro acepta un número de verificación de la Guayana Francesa, una ejecución de regresión antes de un lanzamiento o configurar una sola vez un perfil de negocio regional. Cada número se usa para un único código.
• Los números virtuales dedicados sirven para cuentas que deben seguir recibiendo códigos, como un inicio de sesión de staging que tu equipo de QA abre cada semana. Solo se venden al instante en Estados Unidos y Canadá, desde $1.95/month.

La Guayana Francesa pertenece al primer grupo. No hay una línea +594 de largo plazo de autoservicio; si tu equipo necesita una, escribe a [email protected], y la disponibilidad depende de la normativa local. La comparación de números temporales frente a dedicados ayuda cuando no tienes claro en qué lado cae una tarea.

¿Cómo es la secuencia de la API OTP para la Guayana Francesa?

El id de país de la Guayana Francesa es gf. Con una clave Bearer (prefijo or_live_) contra https://otproute.com/api/v1:

1. GET /api/v1/prices?country=gf&service=<id> devuelve el precio en vivo e indica si la ruta está abierta.
2. POST /api/v1/activations con {"service": "facebook", "country": "gf"} reserva un número +594 y devuelve un id de activación.
3. Tu prueba introduce el número en la app que se está probando.
4. El código te llega mediante activation.sms_received en un webhook, o con GET /api/v1/activations/{id} si haces polling.
5. POST /api/v1/activations/{id}/cancel libera un pedido que la prueba ya no necesita.

Las solicitudes de webhook incluyen X-OTPRoute-Signature con la forma t=<unix>,v1=<hex>. Calcula HMAC-SHA256 de "<t>.<raw body>" con el secreto del endpoint, compara en tiempo constante, rechaza las marcas de tiempo antiguas y elimina duplicados por el id de activación. Los límites por cuenta son 10 claves de API, 5 endpoints de webhook y 300 solicitudes por minuto; la referencia completa está en la documentación.

¿Por qué los números +594 confunden a la validación telefónica?

La Guayana Francesa es una región de ultramar de Francia y sigue el plan de numeración francés, pero tiene su propio prefijo de país, +594, en lugar del +33 de Francia. A nivel nacional, los números tienen diez dígitos con un 0 inicial: los móviles suelen empezar por 0694 y las líneas fijas por 0594. En formato internacional se elimina el 0, así que un móvil pasa a ser +594 694 XX XX XX.

Este esquema genera algunos errores clásicos, y un número +594 para pruebas es la forma más fácil de detectarlos:

• Un selector de país que agrupa los territorios franceses bajo Francia y antepone +33 a un número 0694.
• Bibliotecas de teléfonos que informan la región como GF mientras tu lógica de negocio solo conoce FR.
• Código de visualización que formatea en pares de dígitos al estilo francés pero guarda la cadena con formato en lugar de E.164.

Guarda +594… sin espacios y mantén región y país como conceptos separados en tu modelo de datos.

¿Qué apps pueden enviar códigos de verificación a números de la Guayana Francesa?

Actualmente hay más de 700 servicios disponibles en la ruta de la Guayana Francesa. La instantánea en vivo incluye WhatsApp, Facebook, Instagram, Google (Gmail y YouTube), TikTok, Snapchat, Telegram, Microsoft y Outlook, Amazon, Airbnb, Uber y LinkedIn.

El texto del SMS suele estar en francés, el idioma que usa la mayoría de las cuentas locales, pero cada servicio elige sus propias plantillas, así que extrae los dígitos en lugar de buscar una frase concreta. Los equipos hacen pruebas aquí al localizar flujos en francés más allá de la Francia metropolitana, al atender a clientes de las regiones francesas de ultramar o al comprobar que una cuenta regional sigue verificándose tras un cambio de configuración.

¿Cómo se pide un número +594 desde el panel?

No hace falta código:

1. Regístrate con tu correo y un código de 6 dígitos enviado por email, o con el inicio de sesión de Google, y activa de paso la autenticación en dos pasos TOTP.
2. Recarga el monedero con tarjeta o con USDT/USDC.
3. Elige la Guayana Francesa y el servicio; el precio se muestra antes de confirmar.
4. Pega el número en la app y observa la página de la activación para ver el código.

El personal de operaciones y los gestores de cuentas de agencias suelen usar esta vía, mientras los ingenieros conectan la API. Ambos usan el mismo monedero.

¿Qué pasa cuando el código nunca llega?

Las activaciones duran 20 minutos. Solo se cobra si llega el código; un pedido cancelado, o una ventana que se cierra sin SMS, devuelve el importe completo al monedero de forma automática.

Si esperas un código +594:

• Deja que termine la ventana; un servicio puede tardar sin que haya ningún problema.
• Comprueba si el servicio acepta números virtuales. Algunos no, y el reembolso existe precisamente para ese caso.
• Reintenta más tarde o elige otra ruta de servicio.
• Evita programar nuevos pedidos instantáneos tras cada fallo; un retroceso exponencial mantiene la ruta +594 utilizable para todos.

Nuestras notas sobre cómo reducir las entregas fallidas de OTP profundizan en el tema. Limita las pruebas en la Guayana Francesa a productos y cuentas de tu equipo, respeta los términos de cada servicio y considera la Política de uso aceptable de OTP Route parte del trato.

¿Cómo se gestionan los pagos, las facturas y las pruebas en sandbox?

OTP Route funciona con un monedero prepago en USD: pago por uso, sin cuota mensual ni plan. Se recarga con tarjeta o con stablecoins USDT/USDC, y tras cada recarga llega por correo una factura en PDF para tu equipo de contabilidad. Las tarifas actuales están en la página de precios.

Los ingenieros que conectan el flujo gf pueden pedir al soporte que pase una cuenta de desarrollo a sandbox. Devuelve números y códigos simulados, de modo que el flujo +594, la verificación del webhook y la lógica de reintentos se pueden probar de extremo a extremo sin gastar fondos del monedero. Desde el punto de vista de la API, el enrutamiento OTP hacia la Guayana Francesa no se diferencia del de cualquier otro mercado: solo cambia el id de país, mientras que la API de verificación por SMS sigue igual.

Preguntas frecuentes

¿Puedo probar el registro de mi app en la Guayana Francesa sin una SIM local?

Sí. Pide un número del OTP Gateway para gf, introdúcelo en tu formulario de registro y lee el código en el panel o desde tu webhook.

¿Un número de la Guayana Francesa es lo mismo que un número francés +33?

No. La Guayana Francesa usa el plan de numeración francés pero tiene su propio prefijo de país, +594, y las bibliotecas de teléfonos la tratan como una región distinta.

¿Cuánto cuesta un código +594?

Desde $0.20 por código, según el servicio; el panel y GET /api/v1/prices muestran el precio en vivo. Si no llega ningún SMS en 20 minutos, se reembolsa automáticamente.

¿Puedo conservar un número de la Guayana Francesa para inicios de sesión posteriores?

No hay opción de autoservicio. Los números dedicados de largo plazo se limitan a Estados Unidos y Canadá; escribe a [email protected] para consultar por +594.

¿En qué idioma llegan los códigos?

Normalmente en francés, aunque cada servicio elige su plantilla y puede seguir el idioma configurado en la cuenta.

¿Puedo probar la integración antes de recargar el monedero?

Pide el modo sandbox para una cuenta de desarrollo. Simula números y códigos para que pruebes el flujo completo sin gastar nada.

¿Por qué no llegó mi código de la Guayana Francesa?

El servicio puede ser lento, puede rechazar números virtuales o la ruta puede estar ocupada. Espera a que termine la ventana y luego reintenta más tarde o por otra ruta; los pedidos fallidos se reembolsan.

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.