Intégrer les codes de vérification du Tchad (+235) à votre pile technique

Quelle est la séquence d'appels d'une requête à l'API OTP du Tchad ?

Les requêtes pour le Tchad utilisent la même URL de base que tous les autres marchés, https://otproute.com/api/v1, signées avec une clé Bearer or_live_. Vous créez les clés dans la console Développeur ; un compte peut en détenir jusqu'à 10 et effectuer 300 requêtes par minute.

Une exécution typique pour le Tchad demande quatre appels :

1. GET /api/v1/countries et GET /api/v1/services pour confirmer que td figure dans la liste et retrouver l'identifiant du service visé par votre test.
2. GET /api/v1/prices?country=td&service=<id> pour lire le prix en direct de ce couple avant de dépenser quoi que ce soit.
3. POST /api/v1/activations avec un corps tel que {"service": "telegram", "country": "td"}. La réponse contient un identifiant d'activation et le numéro +235 à saisir dans l'application testée.
4. Attendez le code, puis laissez l'activation se terminer ou appelez POST /api/v1/activations/{id}/cancel si le test s'interrompt prématurément.

Appeler GET /api/v1/balance au début d'une tâche de CI mérite d'être fait, pour qu'un pipeline échoue bruyamment sur un portefeuille vide au lieu d'expirer en cours de route. La référence complète se trouve dans la documentation pour développeurs.

Comment un récepteur de webhook doit-il traiter les codes +235 ?

Interroger GET /api/v1/activations/{id} toutes les quelques secondes convient à un script isolé. Dès que plusieurs exécuteurs de tests partagent une clé, un webhook est plus propre. Enregistrez un endpoint (cinq par compte) et abonnez-vous à activation.sms_received, activation.expired et activation.cancelled.

Chaque requête inclut un en-tête X-OTPRoute-Signature de la forme t=<unix>,v1=<hex>. Reconstituez la chaîne <t>.<raw body>, signez-la en HMAC-SHA256 avec le secret de l'endpoint, et comparez à v1 en temps constant. Rejetez tout ce dont l'horodatage est périmé ; cela ferme la porte aux requêtes rejouées. Notre guide sur la sécurisation des webhooks OTP avec HMAC l'explique dans plusieurs langages.

Traitez l'identifiant d'activation comme clé d'idempotence. Si le même événement est livré deux fois, la seconde écriture ne doit rien changer, et votre gestionnaire doit renvoyer rapidement un 2xx puis faire le travail lent ensuite.

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

L'instantané en direct pour td liste plus de 1 500 services. Parmi les plus populaires : WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, imo, Signal, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI) et AliExpress.

La disponibilité n'est pas statique. Les routes s'ouvrent et se ferment au cours de la journée à mesure que nos opérateurs partenaires déplacent la capacité ; un service visible ce matin peut manquer cet après-midi. Lisez le catalogue à l'exécution plutôt que de le coder en dur, et gardez un second service dans votre plan de test au cas où le premier serait temporairement indisponible pour le Tchad.

Comment stocker et normaliser un numéro +235 ?

Le Tchad utilise un plan de numérotation fermé : les numéros nationaux comptent huit chiffres et il n'y a pas de préfixe de ligne à retirer ; la forme E.164 est donc simplement +235 suivi de ces huit chiffres. Cela fait du Tchad l'un des marchés les plus faciles à valider.

• Stockez la chaîne E.164 complète dans une seule colonne plutôt que de séparer l'indicatif du pays et le numéro d'abonné.
• Si votre formulaire accepte des espaces ou le groupement par paires que les gens saisissent souvent, retirez-les avant l'enregistrement.
• Vérifiez dans vos tests qu'une valeur avec un 0 initial parasite est rejetée ou nettoyée, car les utilisateurs venant d'autres plans en ajoutent parfois un par habitude.

Le français et l'arabe sont les langues officielles. Le texte d'un SMS de vérification suit néanmoins la langue définie pour l'application ou le compte ; une suite de localisation doit donc vérifier séparément les modèles en français, en arabe et en anglais.

Pourquoi les équipes produit font-elles des tests au Tchad ?

Peu d'équipes d'ingénierie sont installées à N'Djamena, ce qui est précisément pourquoi un numéro +235 à distance est utile. Raisons courantes que nous observons :

• Des lancements en Afrique centrale francophone, où un produit déjà actif dans les marchés voisins ajoute le Tchad à son sélecteur de pays d'inscription et doit prouver que le parcours fonctionne.
• La QA de localisation en arabe et en français, y compris la mise en page de droite à gauche de l'écran de saisie du code.
• Des clients de la diaspora qui gardent un numéro tchadien tout en vivant à l'étranger, ce qui influe sur la façon dont vos règles anti-fraude lisent l'indicatif du pays.
• Des équipes d'exploitation qui gèrent des comptes de messagerie professionnelle pour des partenaires régionaux.

Le schéma plus large est décrit dans le routage OTP par pays.

Et si le code du Tchad n'arrive jamais ?

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

• Laissez une chance à la fenêtre de 20 minutes ; certains émetteurs regroupent leurs messages.
• Vérifiez que le service visé accepte les numéros virtuels. Certains ne le font pas, c'est pourquoi le remboursement existe.
• Réessayez plus tard, ou avec un autre service sur le même pays, plutôt que de recommander en boucle serrée. Des relances rapides peuvent déclencher les propres limites de débit de l'émetteur.
• Confirmez que votre gestionnaire a correctement vérifié la signature ; un webhook rejeté ressemble à un code manquant.

Si la fenêtre se ferme ou si vous annulez, la totalité du montant retourne sur le portefeuille sans ticket de support. D'autres tactiques figurent dans réduire les échecs de livraison OTP.

Existe-t-il une ligne tchadienne de longue durée, et comment est-elle facturée ?

Il n'existe pas de numéro de longue durée en libre-service pour le Tchad. Les Dedicated Numbers sont un produit réservé aux États-Unis et au Canada, à partir de $1.95/mois, avec SMS entrants et sortants et appels depuis le navigateur. Si vous avez besoin d'une ligne +235 durable, écrivez à [email protected] ; la disponibilité dépend de la réglementation locale et nous ne pouvons rien promettre.

Les frais des codes +235 sont prélevés sur un solde prépayé unique en USD ; il n'y a ni formule d'abonnement ni frais mensuels. L'alimentation se fait par carte ou en stablecoins USDT/USDC, et une facture PDF arrive dans votre boîte de réception après chaque dépôt. Les tarifs en direct figurent sur la page des tarifs. Pour le travail d'intégration, demandez un passage en sandbox : il renvoie des numéros et des codes simulés afin de répéter le parcours sans toucher aux fonds du portefeuille. L'ouverture d'un nouveau compte demande un code e-mail à six chiffres, ou une connexion Google si votre équipe la préfère.

Questions fréquentes

Quel est l'identifiant de pays du Tchad dans l'API OTP Route ?

Utilisez td dans le champ country de POST /api/v1/activations et dans la requête de prix.

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

Oui. Commandez un numéro +235 sur l'OTP Gateway, saisissez-le dans votre application et lisez le code depuis le tableau de bord, l'API ou un webhook.

Combien de temps un numéro +235 reste-t-il utilisable ?

Une activation est ouverte 20 minutes et couvre un seul code. Passé ce délai, commandez-en une nouvelle.

Est-ce que je paie quand le SMS n'arrive jamais ?

Non. Si aucun message n'arrive avant la fermeture de la fenêtre, ou si vous annulez, le montant est recrédité automatiquement sur votre portefeuille.

Faut-il retirer un préfixe de ligne des numéros tchadiens ?

Non. Le Tchad n'a pas de préfixe de ligne : la forme stockée est +235 suivi du numéro national à huit chiffres.

Puis-je garder un numéro tchadien pour des connexions ultérieures ?

Pas en libre-service. Les Dedicated Numbers de longue durée n'existent qu'aux États-Unis et au Canada ; pour le Tchad, écrivez à l'équipe pour demander ce qui est possible.

Y a-t-il des règles d'utilisation ?

Oui. Respectez les conditions de chaque service et la politique d'utilisation acceptable d'OTP Route ; la passerelle sert à 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.