Construire un test de vérification +592 autour des webhooks et de l'interrogation

Comment concevoir un flux d'API OTP Guyana centré sur les webhooks ?

Pour tout ce qui dépasse une vérification ponctuelle, laissez la plateforme vous envoyer les codes plutôt que de les réclamer sans cesse. Dans la console développeur, ajoutez un endpoint HTTPS (un compte peut en détenir 5) et abonnez-le à activation.sms_received, ainsi qu'à activation.expired et activation.cancelled, pour que votre exécuteur de tests apprenne les impasses aussi vite que les réussites.

Considérez chaque requête entrante comme non fiable tant qu'elle n'a pas passé la vérification :

• Lisez l'en-tête X-OTPRoute-Signature, de la forme t=<unix>,v1=<hex>.
• Assemblez l'horodatage, un point et le corps de requête non modifié, puis calculez le HMAC-SHA256 de cette chaîne avec le secret de l'endpoint.
• Comparez votre empreinte à v1 en temps constant, et écartez la requête si l'horodatage est périmé.
• Trouvez l'identifiant d'activation dans l'événement ; si vous l'avez déjà traité, renvoyez un succès et ne faites rien de plus.

Cette dernière règle rend le gestionnaire idempotent : une nouvelle livraison après un incident réseau ne perturbe jamais le test. Un traitement plus détaillé se trouve dans la capture d'OTP par webhook.

Quels endpoints et identifiants une commande +592 utilise-t-elle ?

Authentifiez-vous avec une clé Bearer issue de la console développeur ; les clés live commencent par or_live_ et chaque compte peut en conserver jusqu'à 10. L'URL de base est https://otproute.com/api/v1, et l'identifiant pays du Guyana est gy.

Une exécution type lit d'abord GET /api/v1/prices?country=gy&service=<id>, car le prix et la disponibilité de cette route sont des valeurs en direct et non des constantes. Elle envoie ensuite POST /api/v1/activations avec {"service": "<id>", "country": "gy"} et reçoit un numéro +592 ainsi qu'un identifiant d'activation. Sans webhook, l'exécuteur interroge GET /api/v1/activations/{id} toutes les quelques secondes, bien en dessous du plafond de 300 requêtes par minute. Une étape de nettoyage appelle POST /api/v1/activations/{id}/cancel quand le test est interrompu, et un appel préalable à GET /api/v1/balance arrête la suite plus tôt si le portefeuille est bas. Les identifiants de service proviennent de GET /api/v1/services ; le portail développeurs propose des exemples de client pour cette API de vérification SMS.

Comment formater les numéros +592 pour le stockage ?

Le Guyana utilise l'indicatif 592 et des numéros nationaux de sept chiffres sans préfixe de ligne à retirer ; la forme E.164 est donc simplement +592 suivi de ces sept chiffres. On écrit généralement les chiffres en un groupe de trois et un groupe de quatre.

Sans zéro initial à supprimer, la normalisation se résume à effacer les espaces et les tirets et à ajouter l'indicatif quand l'utilisateur ne saisit que les chiffres locaux. Un bug fréquent vient d'un formulaire qui suppose que tout numéro sud-américain comporte un indicatif régional, ou qui impose une longueur minimale supérieure à sept chiffres, et rejette ainsi des saisies guyaniennes valides. Un numéro +592 pour les tests le révèle vite. Enregistrez la chaîne E.164 et n'appliquez le formatage local qu'à l'affichage.

Quels services peuvent recevoir des codes SMS OTP du Guyana, et puis-je commander manuellement ?

La route du Guyana répertorie plus de 900 services. Parmi les plus demandés : WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix et Claude. Cette liste est un instantané du catalogue en direct ; confirmez donc via l'API ou le tableau de bord avant de bâtir un test autour d'un expéditeur précis.

Pour les collègues qui n'écrivent pas de code, le tableau de bord fait le même travail. Connectez-vous, ouvrez l'OTP Gateway, choisissez le Guyana et un service, vérifiez le prix et commandez. Le numéro de vérification du Guyana s'affiche avec un compte à rebours de 20 minutes, et le code apparaît à côté dès son arrivée.

Que doit faire un test quand le code +592 est en retard ou absent ?

Une activation reste ouverte 20 minutes. Vous ne payez que si le code arrive dans cette fenêtre ; si elle expire ou si vous annulez, la totalité du montant retourne sur le portefeuille sans ticket de support.

Gestion raisonnable dans une exécution automatisée :

1. Attendez la fin de la fenêtre avant de déclarer l'échec, sauf si votre test a une limite de temps stricte, auquel cas annulez explicitement.
2. Réessayez plus tard, ou passez à une autre route de service si l'API en propose une.
3. Vérifiez si le service cible accepte les numéros virtuels ; certains les refusent, et le remboursement couvre précisément ce cas.
4. Espacez les nouvelles tentatives avec un délai croissant au lieu de recommander en boucle serrée.

Le guide du routage OTP par pays explique comment choisir des routes de repli.

Pourquoi des équipes testent-elles les parcours d'inscription guyaniens ?

Le Guyana est le seul pays d'Amérique du Sud dont la langue officielle est l'anglais, et Georgetown accueille le Secrétariat de la CARICOM ; il figure donc souvent dans les déploiements qui traitent la Communauté caribéenne comme un seul marché. Un secteur énergétique offshore en pleine croissance a attiré des sous-traitants et fournisseurs internationaux, tandis qu'une importante diaspora aux États-Unis, au Canada et au Royaume-Uni occupe les applications de transferts d'argent, de messagerie et de voyage sur des numéros +592. Le créole guyanais est très parlé au quotidien, mais les SMS de vérification arrivent généralement en anglais. Pour la QA, l'effort porte donc sur la saisie du numéro, les sélecteurs de pays et le libellé du consentement aux SMS plutôt que sur des textes traduits. Limitez chaque vérification à des comptes que votre organisation possède, respectez les conditions de chaque service et gardez à l'esprit que la politique d'utilisation acceptable d'OTP Route s'applique à toutes les commandes.

Puis-je conserver une ligne guyanienne, et comment l'usage est-il facturé ?

Les numéros longue durée en libre-service ne sont pas proposés pour le Guyana. Les numéros dédiés d'OTP Route couvrent uniquement les États-Unis et le Canada, à partir de $1.95/mois. Pour une ligne +592, écrivez à [email protected] et l'équipe vérifiera ce que permet la réglementation locale, sans promesse.

Le paiement passe par un seul portefeuille prépayé en USD : pas d'abonnement mensuel, pas de forfait, recharges par carte ou USDT/USDC, et une facture PDF envoyée par e-mail pour chacune. Un compte de développement peut être basculé en bac à sable sur demande, de sorte que les tests d'intégration s'exécutent avec des numéros et des codes simulés sans toucher au solde. Les tarifs par service figurent sur la page des tarifs.

Questions fréquentes

Puis-je tester l'inscription de mon application au Guyana sans carte SIM d'un opérateur guyanien ?

Oui. Commandez un numéro +592 sur l'OTP Gateway pour votre service, saisissez-le dans votre parcours, et le code apparaît dans le tableau de bord ou arrive sur votre webhook. Les tarifs débutent à $0.20 par code.

Quel identifiant de pays l'API utilise-t-elle pour le Guyana ?

C'est gy, utilisé à la fois dans la requête de prix et dans le corps de la demande d'activation.

Dois-je retirer un zéro initial des numéros guyaniens ?

Non. Le Guyana n'a pas de préfixe de ligne ; la forme E.164 est donc +592 suivi du numéro à sept chiffres.

En quelle langue les messages de vérification +592 arrivent-ils ?

Généralement en anglais, la langue officielle. C'est toutefois l'expéditeur qui décide du libellé, et il peut suivre le réglage de langue de l'application.

Y a-t-il un remboursement si le service n'envoie jamais le SMS ?

Oui, et il est automatique. Si 20 minutes s'écoulent sans code, ou si vous annulez, la totalité du montant retourne sur votre portefeuille.

Puis-je tester toute l'intégration sans dépenser d'argent ?

Demandez au support de basculer votre compte de développement en bac à sable. Il renvoie des numéros et des codes simulés, ce qui permet d'exercer de bout en bout les appels d'API et les webhooks.

Un numéro +592 longue durée est-il disponible ?

Pas en libre-service. Les numéros dédiés ne sont vendus qu'aux États-Unis et au Canada ; écrivez à [email protected] pour vous renseigner sur le Guyana.

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.