Numéros de vérification de Guyane française (+594) pour développeurs et équipes QA

Un code unique ou un numéro à conserver : que propose-t-on pour la Guyane française ?

Avant d'écrire la moindre ligne de code, déterminez quel produit correspond à votre besoin.

• L'OTP Gateway convient aux vérifications ponctuelles : s'assurer que votre parcours d'inscription accepte un numéro de vérification guyanais, lancer un test de non-régression avant une mise en production, ou configurer une seule fois un profil professionnel régional. Chaque numéro ne sert que pour un seul code.
• Les Dedicated Virtual Numbers conviennent aux comptes qui doivent continuer à recevoir des codes, comme un identifiant de préproduction que votre équipe QA ouvre chaque semaine. Ils ne sont vendus instantanément qu'aux États-Unis et au Canada, à partir de $1.95/mois.

La Guyane française relève du premier cas. Il n'existe pas de ligne +594 longue durée en libre-service ; si votre équipe en a besoin, écrivez à [email protected], sachant que la disponibilité dépend de la réglementation locale. Le comparatif entre numéros temporaires et numéros dédiés vous aide à trancher lorsque vous hésitez.

Comment se déroule la séquence d'appels de l'API OTP pour la Guyane française ?

L'identifiant de pays de la Guyane française est gf. Avec une clé Bearer (préfixe or_live_) sur https://otproute.com/api/v1 :

1. GET /api/v1/prices?country=gf&service=<id> renvoie le prix en direct et indique si la route est ouverte.
2. POST /api/v1/activations avec {"service": "facebook", "country": "gf"} réserve un numéro +594 et renvoie un identifiant d'activation.
3. Votre test saisit le numéro dans l'application testée.
4. Le code vous parvient via activation.sms_received sur un webhook, ou via GET /api/v1/activations/{id} si vous interrogez l'API.
5. POST /api/v1/activations/{id}/cancel libère une commande dont le test n'a plus besoin.

Les requêtes de webhook incluent X-OTPRoute-Signature sous la forme t=<unix>,v1=<hex>. Calculez le HMAC-SHA256 de "<t>.<raw body>" avec le secret du point de terminaison, comparez en temps constant, refusez les horodatages périmés et dédupliquez sur l'identifiant d'activation. Les limites par compte sont de 10 clés d'API, 5 points de terminaison de webhook et 300 requêtes par minute ; la référence complète se trouve dans la documentation.

Pourquoi les numéros +594 déroutent-ils la validation des téléphones ?

La Guyane française est une région d'outre-mer de la France et suit le plan de numérotation français, mais elle possède son propre indicatif, +594, et non le +33 de la France. Au niveau national, les numéros comptent dix chiffres avec un 0 initial : les mobiles commencent généralement par 0694 et les lignes fixes par 0594. À l'international, le 0 disparaît, et un mobile devient +594 694 XX XX XX.

Cette organisation provoque quelques bogues classiques, et un numéro +594 pour les tests est le moyen le plus simple de les détecter :

• Un sélecteur de pays qui regroupe les territoires français sous la France et ajoute +33 devant un numéro en 0694.
• Des bibliothèques de téléphonie qui renvoient la région GF alors que votre logique métier ne connaît que FR.
• Un code d'affichage qui formate par paires de chiffres à la française mais enregistre la chaîne formatée au lieu du format E.164.

Enregistrez +594… sans espaces et traitez la région et le pays comme deux notions distinctes dans votre modèle de données.

Quelles applications peuvent envoyer des codes de vérification vers des numéros guyanais ?

Plus de 700 services sont actuellement disponibles sur la route de Guyane française. L'instantané en direct comprend WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Snapchat, Telegram, Microsoft & Outlook, Amazon, Airbnb, Uber et LinkedIn.

Le texte du SMS est généralement en français, comme la plupart des comptes locaux, mais chaque service choisit ses propres modèles : extrayez donc les chiffres plutôt que de chercher une formulation. Les équipes testent ici pour localiser des parcours en français au-delà de la métropole, pour servir des clients dans les régions françaises d'outre-mer, ou pour vérifier qu'un compte régional se valide toujours après un changement de configuration.

Comment commander un numéro +594 depuis le tableau de bord ?

Aucun code n'est nécessaire :

1. Inscrivez-vous avec votre e-mail et un code à 6 chiffres reçu par e-mail, ou avec la connexion Google, et activez au passage l'authentification à deux facteurs TOTP.
2. Alimentez le portefeuille par carte ou en USDT/USDC.
3. Choisissez la Guyane française et le service ; le prix s'affiche avant la confirmation.
4. Collez le numéro dans l'application, puis surveillez la page d'activation pour voir arriver le code.

Les équipes d'exploitation et les responsables de comptes en agence passent généralement par cette voie, tandis que les ingénieurs câblent l'API. Les deux utilisent le même portefeuille.

Que se passe-t-il quand le code n'arrive jamais ?

Les activations durent 20 minutes. Le paiement n'est prélevé que si le code arrive ; une commande annulée, ou une fenêtre qui se ferme sans SMS, restitue automatiquement la totalité du montant au portefeuille.

Si vous attendez un code +594 :

• Laissez la fenêtre aller à son terme ; un service peut être lent sans que rien ne dysfonctionne.
• Vérifiez que le service accepte les numéros virtuels. Certains les refusent, et le remboursement existe précisément pour ce cas.
• Réessayez plus tard ou choisissez une autre route de service.
• Évitez de scripter des recommandes immédiates après chaque échec ; un recul exponentiel garde la route +594 utilisable pour tous.

Nos conseils pour réduire les échecs de livraison d'OTP vont plus loin. Limitez vos tests en Guyane française aux produits et comptes que votre équipe possède, respectez les conditions de chaque service et considérez la politique d'utilisation acceptable d'OTP Route comme faisant partie de l'accord.

Comment gérer les paiements, les factures et les tests en sandbox ?

OTP Route fonctionne avec un portefeuille prépayé en USD : paiement à l'usage, sans abonnement mensuel ni forfait. L'alimentation se fait par carte ou en stablecoins USDT/USDC, et une facture PDF est envoyée par e-mail après chaque recharge pour votre service comptable. Les tarifs actuels figurent sur la page des tarifs.

Les ingénieurs qui câblent le flux gf peuvent demander au support de basculer un compte de développement en sandbox. Celui-ci renvoie des numéros et des codes simulés, ce qui permet de tester de bout en bout le flux +594, la vérification des webhooks et la logique de nouvelle tentative sans dépenser les fonds du portefeuille. Du point de vue de l'API, le routage d'OTP vers la Guyane française ne diffère en rien de celui des autres marchés : seul l'identifiant de pays change, l'API de vérification par SMS restant la même.

Questions fréquentes

Puis-je tester l'inscription de mon application en Guyane française sans carte SIM locale ?

Oui. Commandez un numéro OTP Gateway pour gf, saisissez-le dans votre formulaire d'inscription et lisez le code dans le tableau de bord ou depuis votre webhook.

Un numéro guyanais est-il identique à un numéro français en +33 ?

Non. La Guyane française utilise le plan de numérotation français mais possède son propre indicatif, +594, et les bibliothèques de téléphonie la traitent comme une région distincte.

Combien coûte un code +594 ?

À partir de $0.20 par code, selon le service ; le tableau de bord et GET /api/v1/prices affichent le prix en direct. Sans SMS sous 20 minutes, le remboursement est automatique.

Puis-je garder un numéro guyanais pour des connexions ultérieures ?

Il n'existe pas d'option en libre-service. Les Dedicated Numbers longue durée sont réservés aux États-Unis et au Canada ; écrivez à [email protected] pour vous renseigner sur le +594.

En quelle langue les codes arrivent-ils ?

Généralement en français, mais chaque service choisit son propre modèle et peut suivre la langue configurée sur le compte.

Puis-je tester l'intégration avant d'alimenter le portefeuille ?

Demandez le mode sandbox pour un compte de développement. Il simule des numéros et des codes afin d'essayer tout le flux sans rien dépenser.

Pourquoi mon code de Guyane française n'est-il pas arrivé ?

Le service peut être lent, refuser les numéros virtuels, ou la route peut être saturée. Attendez la fin de la fenêtre, puis réessayez plus tard ou sur une autre route ; les commandes échouées sont remboursées.

Les noms de services sont des marques déposées de leurs propriétaires respectifs. OTP Route n'est affilié à aucun d'entre eux. Utilisez les numéros de manière licite et respectez les conditions de chaque service ainsi que notre Politique d'utilisation acceptable.