Checklist avant décollage pour recevoir des codes de vérification +372 en Estonie

Que mettre sur la checklist avant la première commande +372 ?

La plupart des tests qui échouent s'expliquent par un élément manquant avant même la demande du numéro. Cochez d'abord ces points :

• Une clé d'API créée dans la console développeur. Chaque clé porte le préfixe or_live_ et circule comme jeton Bearer ; avec 10 clés possibles par compte, le runner de CI mérite la sienne.
• Un endpoint de webhook dont le secret est stocké côté serveur, si vous préférez être appelé plutôt que d'interroger l'API. Cinq endpoints sont autorisés par compte.
• Les bons identifiants. L'Estonie est ee dans toutes les requêtes, et l'identifiant du service provient de GET /api/v1/services.
• Une vérification du prix en direct. Appelez GET /api/v1/prices?country=ee&service=<id> pour que le job connaisse le coût avant d'engager des fonds du portefeuille.
• Le sandbox, si vous êtes encore en phase de câblage. Sur demande, un compte de développement peut passer en mode sandbox, qui renvoie de bout en bout des numéros et des codes simulés sans toucher à votre solde.
• Un budget de requêtes. L'API accepte 300 requêtes par minute et par compte, ce qui est largement suffisant sauf si une suite de tests interroge sans discernement.

Le guide d'intégration de l'API OTP détaille chacun de ces points.

Comment exécuter une requête d'API OTP pour l'Estonie du début à la fin ?

Une fois la checklist validée, la séquence d'appels est courte :

1. POST /api/v1/activations avec le corps {"service": "<id>", "country": "ee"}. La réponse contient un identifiant d'activation et le numéro +372 à saisir dans le formulaire d'inscription ou de connexion testé.
2. Déclenchez le SMS de vérification depuis l'application testée.
3. Attendez le code. Soit votre endpoint reçoit activation.sms_received, soit vous appelez GET /api/v1/activations/{id} à un intervalle raisonnable.
4. Saisissez le code dans l'application et enregistrez le résultat en le rattachant à l'identifiant d'activation.
5. Si le scénario change et que le numéro n'est plus nécessaire, appelez POST /api/v1/activations/{id}/cancel pour libérer aussitôt la réservation.

Pour les livraisons par webhook, lisez l'en-tête X-OTPRoute-Signature (t=<unix>,v1=<hex>), calculez le HMAC-SHA256 sur <t>.<raw body> avec le secret de l'endpoint, comparez en temps constant et rejetez tout ce qui porte un horodatage ancien. Sécuriser les webhooks OTP avec HMAC présente un gestionnaire de référence. Rendez vos écritures idempotentes sur l'identifiant d'activation, car une nouvelle tentative peut livrer deux fois le même événement.

Quels services peuvent envoyer des codes à un numéro de vérification estonien ?

Le relevé en direct pour l'Estonie indique plus de 1 700 services. Parmi les routes populaires : WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, LinkedIn, Microsoft & Outlook, Amazon, Discord, Signal, Uber, Airbnb et ChatGPT (OpenAI).

L'inventaire évolue au fil de la journée : une route qui répondait ce matin peut être mince le soir. Considérez GET /api/v1/countries et le endpoint des prix comme la source de vérité plutôt que de figer une liste dans vos jeux de données de test.

Comment stocker et valider les numéros +372 ?

L'Estonie a l'un des plans de numérotation les plus simples à gérer, ce qui explique justement pourquoi les validateurs paresseux s'y trompent. Il n'y a pas de préfixe national à retirer : un numéro écrit en local correspond aux mêmes chiffres que ceux qui suivent +372. Les numéros mobiles commencent généralement par 5 et comptent sept ou huit chiffres, de sorte qu'une regex exigeant une longueur nationale fixe rejettera des saisies valides.

Règles pratiques pour vos formulaires et votre base de données :

• Stockez la chaîne E.164 complète, par exemple +3725xxxxxxx, et conservez séparément la saisie brute de l'utilisateur si le support en a besoin.
• Ne préfixez jamais un zéro : il n'y a rien à retirer ni à ajouter.
• Testez les deux longueurs de mobile, sept et huit chiffres, dans vos masques de saisie.

Les SMS de vérification destinés aux utilisateurs estoniens arrivent en général en estonien, même si de nombreuses applications suivent la langue du compte ou de l'appareil, et que des modèles en russe ou en anglais sont courants. Si votre produit propose une version estonienne, vérifiez que les lettres comme õ, ä, ö et ü survivent au trajet entre le modèle et le téléphone.

Pourquoi les équipes testent-elles leurs inscriptions avec des numéros estoniens ?

L'Estonie joue au-dessus de sa taille pour les équipes logicielles. Sa réputation d'administration numérique et le programme d'e-résidence font que de nombreux fondateurs et entreprises à distance ont un lien avec le pays, même si leurs équipes vivent ailleurs, et les produits visant la région balte et nordique y sont souvent lancés en premier.

Voici les raisons typiques pour lesquelles un responsable QA demande un numéro +372 pour ses tests :

• Vérifier que les sélecteurs de pays, les masques de téléphone et les modèles de SMS se comportent correctement pour un marché de l'UE au plan de numérotation court.
• Contrôler la localisation des textes estoniens avant une sortie régionale.
• Reproduire un ticket de support d'un client estonien dont le code n'est jamais arrivé.

Consultez QA testing pour voir comment les équipes intègrent ces contrôles dans un cycle de livraison.

Que vérifier quand le code n'arrive jamais ?

Traitez le problème dans l'ordre plutôt que de commander numéro après numéro :

1. Laissez la fenêtre aller à son terme. L'activation reste ouverte 20 minutes, et certains services mettent leurs SMS en file d'attente.
2. Vérifiez que le service accepte les numéros virtuels. Certains les rejettent par politique ; c'est la raison d'être du remboursement.
3. Consultez le statut final. Un événement activation.expired, ou un état « expiré » renvoyé par l'appel GET, signifie qu'aucun SMS n'est arrivé et que l'argent est déjà revenu dans le portefeuille.
4. Réessayez avec patience. Réessayez un peu plus tard, ou essayez une autre route pour le même service, plutôt que de recommander en boucle rapprochée.
5. Contrôlez votre propre déclencheur. Un test qui n'a jamais réellement demandé le SMS ressemble exactement à un code manquant.

Notre article sur la réduction des échecs de livraison OTP énumère d'autres causes à écarter.

Puis-je garder une ligne estonienne durablement, et comment fonctionne la facturation ?

Il n'existe pas de numéro estonien longue durée en libre-service. Les Dedicated Numbers sont un produit réservé aux États-Unis et au Canada, dès $1.95/month ; pour l'Estonie, écrivez à [email protected] si votre équipe a besoin d'une ligne persistante, et l'équipe vous indiquera ce que la réglementation locale permet, sans promesse de disponibilité.

La facturation du routage OTP passe par un seul portefeuille prépayé en USD, sans frais mensuels ni forfait à choisir. Rechargez-le par carte ou en USDT ou USDC, et chaque recharge génère une facture PDF envoyée par e-mail. Les tarifs en vigueur figurent sur la page des tarifs, et la référence des endpoints se trouve dans la documentation.

Questions fréquentes

Puis-je tester le parcours d'inscription estonien de mon application sans carte SIM locale ?

Oui. Commandez un numéro +372 via l'OTP Gateway, utilisez-le dans votre formulaire d'inscription et lisez le code depuis le tableau de bord, un webhook ou le endpoint d'activation.

Quel est l'identifiant de l'Estonie dans l'API OTP Route ?

Utilisez ee comme valeur de country dans les requêtes d'activation et de prix.

Les numéros de téléphone estoniens ont-ils un préfixe national à retirer ?

Non. L'Estonie n'a pas de préfixe national, les chiffres locaux suivent donc +372 sans modification.

Suis-je facturé quand aucun code estonien n'arrive ?

Non. Si rien n'arrive dans la fenêtre de 20 minutes, ou si vous annulez avant, le montant complet retourne automatiquement dans votre portefeuille.

Une personne non développeuse peut-elle commander un numéro de vérification estonien ?

Oui. Dans le tableau de bord, choisissez l'Estonie et le service, confirmez le prix affiché, copiez le numéro dans l'application et attendez que le code s'affiche sur le même écran.

Peut-on répéter l'intégration estonienne avant de dépenser de vrais fonds ?

Demandez au support de basculer votre compte de développement en sandbox, qui renvoie des numéros et des codes simulés pour exécuter tout le flux sans fonds du portefeuille.

Quelles règles s'appliquent à l'utilisation de ces numéros ?

Respectez les conditions de chaque service et l'Acceptable Use Policy d'OTP Route ; les numéros servent à tester et à exploiter vos propres produits et comptes légitimes.

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.