Recevoir des codes de vérification +966 par programmation pour des lancements en Arabie saoudite

À quoi ressemble une activation +966 unique via l’API ?

Commençons par les appels, car la plupart des lecteurs de cette page intègrent une API de vérification par SMS dans une suite de tests ou un outil interne. Tous les points de terminaison se trouvent sous https://otproute.com/api/v1 et attendent une clé Bearer préfixée or_live_, créée dans la console Développeur.

1. GET /api/v1/countries et GET /api/v1/services vous donnent les identifiants. L’Arabie saoudite est sa.
2. GET /api/v1/prices?country=sa&service=<id> renvoie le tarif en direct pour cette combinaison ; consignez-le avec l’exécution du test.
3. POST /api/v1/activations avec {"service": "<id>", "country": "sa"} renvoie un identifiant d’activation et un numéro +966.
4. Votre test saisit le numéro dans l’application, et le code arrive sous forme d’événement ou via GET /api/v1/activations/{id}.
5. Si le test est abandonné, POST /api/v1/activations/{id}/cancel libère le numéro et rembourse le portefeuille.

GET /api/v1/balance est pratique comme contrôle préalable : un job nocturne échoue tôt avec un message clair plutôt qu’en plein milieu. Limites à prévoir : 10 clés et 5 points de terminaison webhook par compte, 300 requêtes par minute.

Comment notre récepteur de webhooks doit-il traiter les événements OTP saoudiens ?

Enregistrez un point de terminaison et abonnez-vous à activation.sms_received, activation.expired et activation.cancelled. Chaque requête comporte X-OTPRoute-Signature sous la forme t=<unix>,v1=<hex>.

• Reconstituez la chaîne signée <t>.<raw body> et calculez le HMAC-SHA256 avec le secret de ce point de terminaison.
• Comparez-la à v1 avec une fonction à temps constant, et rejetez tout ce dont l’horodatage est trop ancien.
• Traitez chaque événement comme rattaché à l’identifiant d’activation, afin qu’une nouvelle livraison ne mette rien à jour deux fois.
• Répondez rapidement par un 2xx et déléguez le travail lent à une tâche en arrière-plan.

L’interrogation reste un repli valable pour les exécuteurs qui n’acceptent pas de connexions entrantes. Nos articles sur la capture d’OTP par webhook et la sécurisation des webhooks OTP avec HMAC vont plus loin.

Pourquoi les équipes produit testent-elles avec un numéro +966 ?

L’Arabie saoudite est l’un des plus grands marchés numériques du Golfe, et les équipes arrivent sur cette page pour des raisons concrètes : une fintech qui prépare l’intégration de résidents saoudiens, une place de marché qui accueille des vendeurs du Golfe, un éditeur SaaS dont le client exige un contrôle de connexion régional, ou une équipe d’exploitation qui gère des comptes professionnels pour un bureau à Riyad ou Djeddah. Dans chaque cas, quelqu’un doit prouver que le parcours fonctionne avec un vrai numéro de vérification saoudien, et le routage OTP via la passerelle évite d’expédier des cartes SIM dans la région. La page intégration fintech décrit ce scénario plus en détail.

Quels services peuvent recevoir des codes sur les routes saoudiennes ?

L’instantané en direct pour l’Arabie saoudite couvre plus de 1 000 services. Parmi les plus utilisés : Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail & YouTube), Telegram, Amazon, Microsoft & Outlook, LinkedIn, Discord et Netflix. Snapchat et X ont une audience particulièrement large dans le Royaume, ce qui en fait des éléments fréquents d’une liste de contrôle de localisation. Les disponibilités évoluent au fil de la journée ; interrogez donc l’API au moment de l’exécution.

Comment formater les numéros +966 et analyser les messages en arabe ?

Localement, les numéros mobiles saoudiens s’écrivent avec un zéro de préfixe interurbain 0, généralement 05 suivi de huit chiffres. La forme internationale supprime ce zéro : +966 5 puis les huit chiffres restants. Normalisez tout en E.164 dès la saisie et retirez le zéro si un utilisateur le tape après l’indicatif pays.

L’arabe est la langue officielle, de sorte que les SMS de vérification peuvent arriver en arabe, en anglais ou dans les deux. L’arabe s’écrit de droite à gauche, et certains modèles peuvent employer des chiffres arabo-indiens plutôt que les chiffres occidentaux. Un analyseur qui convertit ces chiffres en ASCII avant la recherche, et qui journalise le texte brut en UTF-8, évite toute une catégorie de faux échecs agaçants.

Existe-t-il une voie par le tableau de bord pour ceux qui ne codent pas ?

Oui. Connectez-vous à OTP Route, ouvrez l’OTP Gateway, choisissez l’Arabie saoudite et le service, vérifiez le prix et confirmez. Le numéro apparaît immédiatement et le code s’affiche à côté à son arrivée. Un agent du support peut s’en servir pour reproduire en quelques minutes un problème d’inscription signalé par un client.

Que faire si le code n’arrive jamais, et qu’en est-il des lignes long terme et de la facturation ?

Si aucun SMS n’arrive dans les 20 minutes, ou si vous annulez, la totalité du montant retourne automatiquement sur le portefeuille. Laissez la fenêtre se terminer, réessayez plus tard ou via une autre route de service, vérifiez que le service accepte les numéros virtuels et évitez de recommander en boucle serrée.

Il n’existe pas de numéro saoudien long terme en libre-service. Les Dedicated Virtual Numbers ne sont proposés qu’aux États-Unis et au Canada, à partir de $1.95/mois ; pour une ligne +966 long terme, écrivez à [email protected], en gardant à l’esprit que la réglementation locale décide si c’est possible.

Le financement passe par un seul portefeuille prépayé en USD, à l’usage, sans abonnement mensuel. Les paiements par carte comme en USDT/USDC fonctionnent pour les recharges, et chacune génère une facture PDF envoyée par e-mail. Un compte de développement peut être basculé en sandbox sur demande pour obtenir des numéros et des codes simulés. Consultez la page tarifs pour les tarifs en vigueur.

Questions fréquentes

Comment recevoir un SMS OTP saoudien via une API ?

Créez une activation avec le pays sa et l’identifiant de votre service, puis récupérez le code depuis le webhook activation.sms_received ou en interrogeant l’activation.

Un numéro +966 de test est-il facturé si le code échoue ?

Non. L’absence de code signifie que la totalité du montant est rendue au portefeuille à la fin de la fenêtre de 20 minutes ou lors de votre annulation.

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

Oui. L’OTP Gateway délivre un numéro +966 pour un code, que vous saisissez dans votre application et relisez via le tableau de bord ou l’API.

Comment stocker un numéro mobile saoudien saisi sous la forme 05XXXXXXXX ?

Supprimez le zéro de préfixe et enregistrez-le sous la forme +966 5 suivie des huit chiffres restants, en E.164.

Pouvons-nous conserver le même numéro saoudien pour des connexions ultérieures ?

Pas avec un produit en libre-service, car les Dedicated Numbers long terme ne couvrent que les États-Unis et le Canada. Écrivez à l’équipe si vous avez besoin d’une ligne saoudienne, sans garantie qu’elle puisse être fournie.

Existe-t-il un moyen de répéter le parcours saoudien avant d’engager de l’argent réel ?

Oui. Demandez le mode sandbox sur un compte de développement pour recevoir des numéros et des codes simulés, webhooks compris.

Quels usages OTP Route autorise-t-il ?

Tester et exploiter vos propres produits et comptes légitimes. Respectez les conditions de chaque service ; la politique d’utilisation acceptable d’OTP Route s’applique.

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.