Intégrer un flux de vérification SMS égyptien (+20) à l'API OTP Route

De quelles requêtes une intégration de l'API OTP Égypte a-t-elle réellement besoin ?

Sept endpoints couvrent tout, tous sous https://otproute.com/api/v1 et tous authentifiés par une clé Bearer préfixée or_live_. Générez une clé par environnement dans la console Développeur ; un compte peut en contenir jusqu'à 10.

1. Chargez le catalogue avec GET /api/v1/services et GET /api/v1/countries. L'identifiant de pays de l'Égypte est eg ; il change rarement, donc le mettre en cache est sans risque.
2. Avant chaque commande, demandez GET /api/v1/prices?country=eg&service=<id> pour connaître le prix et la disponibilité actuels. Le stock évolue au fil de la journée : traitez cette réponse comme une donnée fraîche, pas comme une configuration.
3. Créez l'activation avec POST /api/v1/activations et un corps tel que {"service": "whatsapp", "country": "eg"}. Vous obtenez un identifiant d'activation et le numéro +20 à saisir dans l'écran testé.
4. Récupérez le code via un webhook ou en appelant GET /api/v1/activations/{id}.
5. Si un test est interrompu, libérez la commande avec POST /api/v1/activations/{id}/cancel pour que les fonds reviennent aussitôt.

Un rapide GET /api/v1/balance en tête de chaque suite permet à un job de CI de s'arrêter tôt plutôt que d'échouer à mi-parcours. La limite est de 300 requêtes par minute et par compte, ce qui laisse de la marge pour interroger plusieurs activations en parallèle. Des exemples complets de requêtes figurent dans la documentation développeur.

Comment consommer les codes +20 depuis un webhook signé plutôt que par polling ?

Le polling convient à un test local isolé ; un webhook est mieux adapté dès qu'un pipeline exécute de nombreuses activations égyptiennes à la fois. Ajoutez un endpoint dans la console Développeur (cinq par compte) et abonnez-le à activation.sms_received, ainsi qu'à activation.expired et activation.cancelled, pour que votre job sache quand cesser d'attendre.

Chaque requête porte X-OTPRoute-Signature: t=<unix>,v1=<hex>. Reconstituez la chaîne <t>.<raw body>, calculez le HMAC-SHA256 avec le secret de l'endpoint et comparez-le à v1 par une vérification en temps constant. Rejetez tout horodatage périmé, et hachez les octets exactement tels que reçus plutôt qu'un objet analysé puis réencodé.

Traitez l'identifiant d'activation comme clé d'idempotence : enregistrez l'événement une fois, ignorez les répétitions et renvoyez rapidement un 2xx. Le guide de capture d'OTP par webhook présente une version de ce gestionnaire adossée à une file d'attente.

Quels services peuvent livrer des codes à un numéro de vérification égyptien ?

Le relevé en direct pour l'Égypte liste plus de 1 600 services au total. Parmi les plus populaires que les équipes testent sur des numéros +20 : WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Uber, Snapchat, Viber, imo, ChatGPT (OpenAI), Amazon et LinkedIn.

Cette liste est une vue à un instant donné, pas une promesse. Un service qui dispose de numéros ce matin peut en manquer cet après-midi, et c'est précisément pourquoi le endpoint des prix indique la disponibilité en plus du coût. Certains services refusent aussi purement et simplement les numéros virtuels ; dans ce cas, la règle de remboursement décrite plus bas vous protège.

Comment une application doit-elle stocker et valider les numéros de mobile égyptiens ?

L'Égypte utilise l'indicatif +20 et un préfixe de tronc national 0. Localement, un numéro de mobile s'écrit avec onze chiffres commençant par 01, tandis qu'en forme internationale le zéro disparaît et dix chiffres suivent le +20. Quelques habitudes évitent la plupart des bugs :

• N'enregistrez que l'E.164, par exemple +201XXXXXXXXX, et formatez pour l'affichage au moment du rendu.
• Retirez le zéro de tronc lorsqu'un utilisateur saisit 01… alors que le pays est déjà réglé sur l'Égypte ; sinon vous obtenez une valeur invalide +2001….
• Normalisez les chiffres. Les utilisateurs de claviers arabes peuvent saisir des chiffres arabo-indiens : convertissez-les en chiffres ASCII avant la validation et avant de comparer un OTP saisi.

L'arabe est la langue officielle ; de nombreux services envoient donc leurs codes en arabe aux utilisateurs égyptiens, tandis que d'autres utilisent l'anglais par défaut. Si votre analyseur extrait le code avec une regex, testez-le sur des corps de message de droite à gauche comme sur des messages en anglais.

L'équipe d'exploitation peut-elle commander un numéro égyptien sans écrire de code ?

Oui. Toutes les vérifications ne nécessitent pas un script, et les collègues du support ou de la croissance peuvent utiliser la même OTP Gateway depuis le navigateur :

1. Inscrivez-vous avec votre e-mail et le code à 6 chiffres, ou avec Google.
2. Rechargez le portefeuille et ouvrez l'OTP Gateway.
3. Choisissez l'Égypte et le service ; le prix s'affiche avant que vous ne confirmiez.
4. Copiez le numéro +20 dans l'application et attendez que le code apparaisse à l'écran.

L'activation est identique à une commande par API : une vérification manuelle et une vérification automatisée se comportent donc de la même façon.

Et si le code +20 n'arrive jamais ?

Chaque activation reste ouverte 20 minutes. Si aucun SMS n'arrive dans ce délai, ou si vous annulez avant, la totalité du montant retourne automatiquement sur votre portefeuille : un numéro silencieux ne vous coûte donc jamais rien.

Quand les codes échouent de façon répétée :

• Laissez la fenêtre aller à son terme avant de conclure à un échec ; le délai de livraison dépend du service et de la route.
• Vérifiez que le service accepte les numéros virtuels. Certains les refusent, et aucun choix de routage n'y change rien.
• Réessayez un peu plus tard, ou via une route voisine si votre test ne dépend pas d'un numéro égyptien.
• Évitez de recommander en boucle serrée. Laissez un intervalle croissant entre les commandes et conservez chaque identifiant d'activation dans vos journaux.

Nos notes sur la réduction des échecs de livraison OTP approfondissent la politique de nouvelle tentative.

Pourquoi les équipes produit testent-elles avec des numéros égyptiens ?

L'Égypte est l'un des plus grands marchés arabophones : c'est donc une première étape naturelle pour les équipes qui localisent un produit en arabe. Un vrai numéro +20 met à l'épreuve ce que les émulateurs ignorent : le sélecteur de pays, la gestion du zéro de tronc, les modèles de SMS en arabe et la mise en page de droite à gauche de l'écran de saisie du code.

Les équipes d'exploitation régionales utilisent aussi le routage OTP pour confirmer qu'un parcours d'inscription fonctionne toujours pour les clients égyptiens après une mise en production, et les entreprises qui servent des Égyptiens vivant à l'étranger vérifient qu'un numéro +20 est également accepté hors du pays.

Existe-t-il une ligne égyptienne longue durée, et comment fonctionne la facturation ?

Il n'existe pas de numéro longue durée pour l'Égypte en libre-service. Les lignes dédiées sont un produit réservé aux États-Unis et au Canada, dès $1.95/mois ; si vous avez besoin d'une ligne égyptienne durable, écrivez à [email protected] et l'équipe vous dira si c'est possible selon la réglementation locale, sans promettre que ce le soit.

La facturation repose sur un portefeuille USD prépayé, sans abonnement mensuel ni formule à choisir. Les fonds entrent par carte ou en USDT/USDC, et chaque recharge est suivie d'une facture PDF envoyée par e-mail. Pendant que vous construisez l'intégration, vous pouvez demander le mode sandbox pour un compte de développement, qui renvoie des numéros et des codes simulés sans toucher aux fonds du portefeuille. Les tarifs actuels sont sur la page des tarifs.

Questions fréquentes

Puis-je vérifier l'OTP d'inscription égyptien de mon application sans carte SIM égyptienne ?

Oui. Commandez un numéro +20 auprès de l'OTP Gateway, saisissez-le dans votre formulaire d'inscription et lisez le code dans le tableau de bord ou via l'API, sans aucune SIM locale.

Quel identifiant de pays l'API OTP Route utilise-t-elle pour l'Égypte ?

L'Égypte est eg. Passez-le au endpoint des prix et dans le corps de POST /api/v1/activations.

Dois-je payer un numéro +20 si le SMS n'arrive jamais ?

Non. Si aucun code n'arrive dans les 20 minutes, ou si vous annulez l'activation, la totalité du montant est automatiquement recréditée sur votre portefeuille.

Dois-je conserver le zéro initial en enregistrant un numéro de mobile égyptien ?

Non. Le 0 est un préfixe de tronc national ; retirez-le et stockez le numéro en E.164, en commençant par +20.

Puis-je me reconnecter le mois prochain avec le même numéro de test égyptien ?

Pas de façon fiable. Chaque numéro de l'OTP Gateway sert pour un seul code de vérification, et les lignes dédiées en libre-service n'existent que pour les États-Unis et le Canada : prévoyez en conséquence les comptes qui exigent des connexions répétées.

Puis-je utiliser des numéros égyptiens pour ouvrir de nombreux comptes sur une plateforme ?

Non. OTP Route sert à tester et à exploiter vos propres produits et comptes légitimes ; respectez les conditions de chaque service et la politique d'utilisation acceptable.

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.