Intégrer des codes de vérification équatoriens (+593) à vos exécutions de test

Pourquoi notre parcours d'inscription en Équateur reste-t-il bloqué en attente d'un téléphone ?

Le schéma est bien connu. Une équipe produit ajoute l'Équateur à sa liste de lancements, l'écran d'inscription demande un mobile +593, et personne côté QA n'en possède un. Quelqu'un commande une SIM prépayée, elle dort dans un tiroir dans une autre ville, et chaque exécution de non-régression dépend désormais d'un collègue qui dicte les codes à voix haute dans un fil de discussion.

Ce montage s'effondre dès que les tests tournent la nuit ou en parallèle. Il fait aussi circuler des codes dans des endroits où ils n'ont rien à faire. OTP Route remplace la SIM du tiroir par du routage OTP via une API : votre test demande un numéro équatorien, le SMS de vérification arrive de notre côté, et le code est remis au job qui l'a demandé. Personne n'a besoin d'être réveillé, et aucun téléphone personnel n'est impliqué.

Quelles applications peuvent envoyer des codes à un numéro de vérification équatorien ?

La route équatorienne propose actuellement plus de 1 700 services. Parmi les plus populaires du relevé en direct : WhatsApp, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), LinkedIn, Microsoft & Outlook, Uber, Airbnb, Netflix, Discord et ChatGPT (OpenAI).

Cette liste évolue au cours de la journée, car le stock provient en temps réel de nos partenaires opérateurs. Voyez-la comme un repère, non comme une promesse : la réponse faisant foi à la minute près est ce que renvoie GET /api/v1/prices pour votre service et l'identifiant de pays ec. Le catalogue complet est consultable sur la page des services.

À quoi ressemble en code la séquence de l'API OTP Équateur ?

Tout se trouve sous https://otproute.com/api/v1 et s'authentifie avec une clé Bearer préfixée or_live_, générée dans la console Développeur. Une étape de test type se déroule ainsi :

1. Consultez le prix et la disponibilité en direct avec GET /api/v1/prices?country=ec&service=<id>.
2. Créez la commande avec POST /api/v1/activations et un corps tel que {"service": "uber", "country": "ec"}. Vous obtenez un identifiant d'activation et le numéro +593.
3. Saisissez ce numéro dans le formulaire d'inscription de votre propre application et déclenchez le SMS.
4. Faites attendre votre job équatorien sur l'événement activation.sms_received, avec un repli sur GET /api/v1/activations/{id} toutes les quelques secondes.
5. Lorsqu'un test plante en cours de route, libérez la commande +593 avec POST /api/v1/activations/{id}/cancel.

Les livraisons de webhook portent un en-tête X-OTPRoute-Signature. Recalculez le HMAC-SHA256 sur l'horodatage, un point et le corps brut avec le secret de l'endpoint, comparez en temps constant et rejetez les horodatages périmés. Le guide d'intégration présente un client complet d'API de vérification par SMS, et la documentation liste chaque champ.

Comment notre base de données doit-elle stocker les mobiles +593 ?

Les Équatoriens écrivent généralement un numéro de mobile avec un 0 initial, par exemple 09 suivi de huit autres chiffres. Ce zéro est un préfixe de tronc utilisé uniquement pour la numérotation nationale. En E.164, il disparaît, laissant +593 et un numéro national de neuf chiffres commençant par 9.

• Stockez une seule forme canonique : +5939XXXXXXXX. Retirez espaces, tirets et zéro de tronc à la saisie.
• Acceptez à la fois 09… et +593 9… dans le champ du formulaire, car les habitants tapent l'un ou l'autre.
• Ne supposez pas l'anglais dans les modèles de message. La langue officielle de l'Équateur est l'espagnol, donc la plupart des codes arrivent dans un texte espagnol ; extrayez les chiffres plutôt que de chercher des mots comme « code ».

Une petite commodité pour les tests de facturation : l'Équateur utilise le dollar américain comme monnaie, ce qui correspond au portefeuille en USD que vous rechargez sur OTP Route.

Le code n'est pas arrivé en Équateur. Que faire ?

Un numéro silencieux relève généralement d'un problème de route ou d'acceptation, pas d'un bug de votre banc de test. Procédez dans cet ordre :

• Laissez la fenêtre de 20 minutes se terminer. Si rien n'est arrivé, la totalité du montant retourne automatiquement sur votre portefeuille : il n'y a donc aucune raison d'annuler tôt.
• Vérifiez si le service destiné à l'Équateur tolère les numéros virtuels. Certains les rejettent par politique, et c'est exactement pourquoi la règle de remboursement existe.
• Réessayez plus tard, ou commandez une nouvelle activation pour le même service afin qu'un autre numéro soit utilisé.
• Évitez de recommander en boucle serrée ; un court délai croissant (backoff) protège à la fois votre portefeuille et la route.

Si vous devez recevoir de façon fiable des codes SMS OTP équatoriens en CI, intégrez le backoff au banc de test lui-même. Notre article sur la réduction des échecs de livraison OTP propose d'autres schémas pour la logique de nouvelle tentative.

Peut-on garder un numéro équatorien pour des comptes qui se reconnectent ?

Pas en libre-service. Les Dedicated Numbers longue durée ne sont vendus que pour les États-Unis et le Canada, dès $1.95/mois, avec SMS entrants, transfert par webhook, SMS sortants et appels depuis le navigateur. Pour l'Équateur, il n'existe aujourd'hui aucune ligne longue durée en libre-service. Si votre cas d'usage en exige vraiment une, écrivez à [email protected] en le décrivant ; la disponibilité dépend de la réglementation locale et ne peut pas être promise.

Comment les codes équatoriens sont-ils facturés, et peut-on tester gratuitement d'abord ?

OTP Route fonctionne avec un seul portefeuille USD prépayé, sans abonnement mensuel ni formule à choisir. Vous rechargez par carte ou en USDT/USDC, et chaque recharge produit une facture PDF envoyée par e-mail. Chaque activation ne prélève sur ce solde que lorsqu'un code est livré.

Avant de dépenser quoi que ce soit, demandez le mode sandbox pour un compte de développement. Il renvoie des numéros et des codes simulés, ce qui permet d'exercer de bout en bout votre job de CI, votre vérificateur de webhook et votre analyseur. Les équipes qui l'intègrent à leurs pipelines partent souvent de notre présentation des tests QA. Comme toujours, respectez les conditions de chaque service et notre politique d'utilisation acceptable.

Questions fréquentes

Puis-je tester l'inscription de mon application en Équateur sans carte SIM locale ?

Oui. Commandez une activation pour l'identifiant de pays ec, saisissez le numéro +593 dans votre application et lisez le code dans le tableau de bord, par webhook ou par un appel de polling.

Combien coûte un code de vérification équatorien ?

Les codes démarrent à $0.20 par code ; le montant exact dépend du service et s'affiche dans le tableau de bord ou est renvoyé par le endpoint des prix avant la commande.

Dois-je payer si le numéro +593 ne reçoit aucun SMS ?

Non. Lorsque la fenêtre de 20 minutes se ferme sans message, ou si vous annulez avant, la totalité du montant retourne sur votre portefeuille.

Dois-je saisir le zéro initial en entrant un numéro équatorien ?

Seulement si votre formulaire attend le format national. En forme internationale, le zéro de tronc disparaît : le numéro se lit +593 suivi de neuf chiffres commençant par 9.

En quelle langue seront les messages OTP équatoriens ?

Surtout en espagnol, même si certaines applications mondiales envoient en anglais. Analysez le code numérique plutôt que de vous fier aux mots qui l'entourent.

Existe-t-il un numéro +593 de test que je puisse garder pendant des mois ?

Aucune option en libre-service n'existe pour l'Équateur ; les lignes longue durée sont un produit réservé aux États-Unis et au Canada. Vous pouvez écrire à [email protected] pour vous renseigner sur des cas particuliers.

Puis-je commander des numéros équatoriens depuis un navigateur plutôt que par l'API ?

Oui. Connectez-vous, choisissez le service et l'Équateur dans l'OTP Gateway, confirmez le prix affiché, et le code apparaît sur le même écran à son arrivée.

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.