Tester la vérification turque sur des numéros +90, étape par étape

Check-list préalable : que préparer avant de demander un numéro +90 ?

Une courte check-list évite de gaspiller des activations lorsqu'un plan de test turc passe en production :

1. Retrouvez l'identifiant de service de l'application via GET /api/v1/services et vérifiez l'identifiant de pays tr via GET /api/v1/countries.
2. Appelez GET /api/v1/prices?country=tr&service=<id> pour connaître le prix actuel de la combinaison et sa disponibilité.
3. Assurez-vous que le portefeuille couvre la campagne grâce à GET /api/v1/balance.
4. Enregistrez un endpoint de webhook (un compte peut en avoir jusqu'à cinq) et gardez son secret hors du dépôt de code.
5. Réglez votre bibliothèque de validation téléphonique sur la région TR et décidez comment l'interface réaffiche le numéro au testeur.
6. Chargez la locale turque dans votre environnement de test, car les bugs de casse des chaînes y apparaissent souvent en premier.

Pourquoi le 0 initial fait-il trébucher la validation des numéros turcs ?

En Turquie, on écrit les numéros mobiles avec un préfixe national, par exemple 0 5XX XXX XX XX. À l'international, le zéro disparaît : la forme canonique est +90 suivi d'un numéro national à dix chiffres, et les mobiles commencent par 5 après l'indicatif du pays.

Les formulaires qui acceptent les deux styles ont besoin d'une étape de normalisation. Supprimez espaces et ponctuation, retirez un seul 0 initial quand la région est TR, ajoutez +90, puis enregistrez le résultat en E.164 (+905…). Ne conservez jamais le zéro du préfixe national dans la valeur stockée, sinon un même testeur ressemblera à deux utilisateurs différents dans votre base. Réaffichez-le au format national si vos utilisateurs turcs s'y attendent.

À quoi ressemble un SMS de vérification turc pour votre analyseur ?

Le turc est la langue officielle, et les expéditeurs locaux rédigent leurs codes en turc, avec des lettres comme ç, ş, ğ, ı, ö et ü. Les applications internationales suivent plutôt la langue de l'appareil ou du compte. Dans les deux cas, extrayez le code avec un motif de chiffres plutôt qu'en cherchant les mots environnants.

La locale turque cache aussi un piège logiciel bien connu : mettre un i minuscule en majuscule donne un İ pointé, et mettre un I en minuscule donne un ı sans point. Un code qui compare des chaînes avec une casse dépendante de la locale peut casser la connexion ou la vérification des e-mails des utilisateurs turcs. Une passe de test +90 est le bon moment pour le repérer, ainsi que les masques de saisie à la bonne longueur et les messages d'erreur traduits. Le guide de vérification des applications mobiles couvre des contrôles voisins.

Quelles applications peuvent envoyer des codes vers un numéro de vérification turc ?

Le relevé actuel pour tr comprend WhatsApp, Telegram, Instagram, TikTok, X (Twitter), Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Uber, Netflix, AliExpress, Discord, ChatGPT (OpenAI) et Amazon. Au total, la route turque couvre plus de 1 800 services.

Les équipes commandent ici pour lancer un produit en Turquie, vérifier la localisation avant une campagne marketing, ou servir des clients turcophones installés ailleurs en Europe. Comme la capacité évolue au fil de la journée, fiez-vous à la liste de prix en direct plutôt qu'à une liste figée dans votre configuration de test.

Comment demander et lire un OTP turc via l'API ?

La séquence d'appels est courte. Envoyez POST /api/v1/activations avec {"service": "<id>", "country": "tr"} et une clé Bearer préfixée or_live_. Saisissez le numéro +90 renvoyé dans l'application testée. Lorsque le SMS arrive, OTP Route déclenche activation.sms_received vers votre endpoint ; si la fenêtre se ferme avant, vous recevez activation.expired, et un arrêt manuel produit activation.cancelled.

Avant de faire confiance à un événement, recalculez la signature à partir de l'en-tête X-OTPRoute-Signature : HMAC-SHA256 de l'horodatage, d'un point et du corps brut de la requête, avec le secret de l'endpoint comme clé. Rejetez tout horodatage ancien et traitez les livraisons répétées pour un même identifiant d'activation comme un seul événement. L'interrogation de GET /api/v1/activations/{id} sert de solution de repli pour les environnements sans HTTP entrant. L'article sur la capture d'OTP par webhook et le hub développeurs vont plus loin.

Vous préférez cliquer plutôt que coder ? Utilisez le tableau de bord

Les collègues non techniques suivent la même logique dans le navigateur. Connectez-vous, créditez le portefeuille, choisissez le service et la Turquie, puis copiez le numéro +90 dans l'application. Le SMS entrant s'affiche sur la fiche d'activation. Chaque numéro temporaire sert pour un code, pendant une fenêtre de 20 minutes.

Que faire si le code turc n'arrive pas ?

• Laissez passer les 20 minutes complètes avant de conclure à un échec.
• Vérifiez que l'application accepte les numéros virtuels ; certaines les refusent, et le remboursement automatique existe pour ce cas.
• Réessayez un peu plus tard, ou via la route d'un autre service si votre test le permet.
• Espacez les nouvelles tentatives au lieu de commander en boucle rapide.

Une commande qui se termine sans code ne coûte rien, puisque le montant total retourne dans le portefeuille.

Facturation, sandbox et numéros longue durée

OTP Route fonctionne avec un portefeuille USD prépayé, sans forfait à choisir. Les recharges par carte et en USDT/USDC sont toutes deux prises en charge, et chacune déclenche une facture PDF envoyée par e-mail. Les développeurs peuvent demander la bascule d'un compte de développement en mode sandbox, qui renvoie des numéros et des codes simulés pour des tests de bout en bout sans dépenser de fonds.

Il n'existe pas de numéro turc longue durée en libre-service. Les équipes qui en ont besoin peuvent écrire à [email protected] ; la réponse dépend de la réglementation locale. Pour des lignes que vous conservez et renouvelez, les numéros dédiés sont proposés aux États-Unis et au Canada, dès $1.95/month.

Questions fréquentes

Puis-je vérifier l'inscription turque de mon application sans carte SIM turque ?

Oui. Un numéro temporaire +90 de l'OTP Gateway reçoit le code, que vous lisez dans le tableau de bord ou via l'API.

Dois-je stocker les numéros turcs avec le 0 initial ?

Non. Stockez-les en E.164 sous la forme +90 suivi du numéro national à dix chiffres, et n'ajoutez le 0 du préfixe national qu'à l'affichage d'un format domestique.

Quel est l'identifiant de pays de l'API pour la Turquie ?

C'est tr. Passez-le dans le champ country de POST /api/v1/activations ainsi que dans la requête de prix.

Combien coûte un numéro +90 pour les tests ?

Les activations turques démarrent à $0.20 par code, et chaque application a son propre tarif. Le tableau de bord et GET /api/v1/prices l'affichent avant votre commande.

Que se passe-t-il si le code n'est pas livré ?

Si aucun SMS n'arrive dans les 20 minutes, ou si vous annulez l'activation, le montant total est recrédité sur votre portefeuille.

Un numéro turc peut-il être conservé pour des connexions ultérieures ?

Pas en libre-service. Écrivez à [email protected] pour vous renseigner, en sachant que la disponibilité dépend des règles locales.

Existe-t-il des règles d'utilisation des numéros ?

Oui. Les numéros turcs sont destinés aux tests et à l'exploitation de produits et de comptes qui vous appartiennent ; les conditions de chaque application restent applicables, tout comme la politique d'utilisation acceptable d'OTP Route.

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.