API de vérification SMS Nigeria (+234) pour les équipes QA, fintech et lancement

Quels endpoints appeler pour recevoir un OTP nigérian ?

Tout se passe sous https://otproute.com/api/v1 avec une clé Bearer commençant par or_live_. L'identifiant de pays du Nigeria est ng. Une intégration type enchaîne quatre appels :

1. GET /api/v1/prices?country=ng&service=<id> pour confirmer le prix actuel avant de vous engager.
2. POST /api/v1/activations avec {"service": "<id>", "country": "ng"} pour réserver un numéro +234. Conservez l'identifiant d'activation renvoyé : chaque appel suivant et chaque événement webhook s'y rattache.
3. GET /api/v1/activations/{id} pour lire le statut et, une fois le SMS livré, le code.
4. POST /api/v1/activations/{id}/cancel si votre test échoue en amont et que vous n'avez plus besoin du numéro.

GET /api/v1/balance est pratique comme contrôle préalable en CI : une suite nocturne échoue vite quand le portefeuille est presque vide. Le guide d'intégration de l'API OTP détaille la même séquence avec la gestion des erreurs.

Une suite de tests à Lagos doit-elle utiliser le polling ou les webhooks ?

Le polling convient pour quelques essais manuels. Dès qu'un pipeline commande plusieurs numéros +234 en parallèle, les webhooks sont plus propres. Enregistrez l'un de vos cinq endpoints dans la console développeur et abonnez-vous à activation.sms_received, activation.expired et activation.cancelled.

Chaque requête porte X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalculez le HMAC-SHA256 sur l'horodatage, un point et le corps brut avec le secret de votre endpoint, comparez en temps constant, et rejetez la requête si l'horodatage est ancien. Mémorisez les identifiants d'activation traités pour qu'un événement renvoyé ne déclenche pas deux fois votre test. L'article sur la sécurisation des webhooks OTP avec HMAC propose une liste de contrôle plus complète. Restez sous 300 requêtes par minute et par compte, ce qui laisse de la marge si vous misez sur les événements plutôt que sur un polling serré.

Quels services sont disponibles sur les routes +234 ?

La route ng répertorie actuellement plus de 2 700 services. Parmi les plus demandés : WhatsApp, Telegram, Google (Gmail & YouTube), TikTok, Facebook, Instagram, X (Twitter), Snapchat, LinkedIn, Uber, Discord, Microsoft & Outlook, Amazon et ChatGPT (OpenAI). Le stock évolue au fil de la journée à mesure que nos opérateurs partenaires mettent à jour leur offre : interrogez donc la disponibilité en direct plutôt que de supposer qu'un service vu hier est toujours là.

Pourquoi les équipes ont-elles besoin d'un numéro de vérification nigérian ?

Le Nigeria est l'un des marchés fintech et d'applications grand public les plus actifs d'Afrique, et de nombreux produits font du numéro de téléphone l'identifiant principal. L'étape SMS devient alors décisive à l'inscription pour les portefeuilles mobiles, les applications de prêt, les VTC, la livraison et les réseaux sociaux. Les équipes hors du pays utilisent un numéro +234 pour les tests afin de vérifier que le parcours d'inscription, le délai de renvoi et les messages d'erreur se comportent comme pour un utilisateur local.

L'anglais est la langue officielle ; les SMS de vérification arrivent donc en général en anglais, ce qui simplifie les assertions dans les tests automatisés. Les équipes fintech peuvent consulter la page onboarding fintech pour voir comment cela s'articule avec des contrôles d'identité qu'OTP Route ne remplace pas.

Comment sont formatés les numéros mobiles nigérians ?

L'indicatif du pays est +234 et le préfixe national est 0. Les Nigérians écrivent d'ordinaire un numéro mobile en onze chiffres commençant par zéro, par exemple 0803 123 4567 ; au format international, le zéro disparaît : +234 803 123 4567. Enregistrez la valeur E.164 (+234803...), acceptez le format local à onze chiffres en saisie et supprimez le 0 initial avant l'enregistrement. Un validateur qui ne contrôle que la longueur totale acceptera sans broncher +2340803..., une cause fréquente d'échecs d'envoi en production.

Puis-je commander un numéro nigérian depuis le tableau de bord ?

Oui. Inscrivez-vous avec un code reçu par e-mail ou via Google, alimentez le portefeuille, ouvrez l'OTP Gateway, choisissez le Nigeria et le service, puis confirmez le prix affiché. Le numéro est prêt immédiatement et le code apparaît à côté de la commande dès son arrivée.

S'il n'arrive pas, laissez la fenêtre de 20 minutes aller à son terme : vous ne payez que si le code arrive, et les commandes expirées ou annulées sont remboursées automatiquement. Réessayez ensuite un peu plus tard, essayez une autre route comme le Ghana si votre test le permet, et vérifiez si le service refuse les numéros virtuels. Évitez de lancer de nouvelles commandes en boucle serrée.

Et pour les lignes nigérianes durables, la facturation et le sandbox ?

OTP Route ne propose pas de numéro nigérian de longue durée en libre-service. Les Dedicated Numbers sont vendus uniquement pour les États-Unis et le Canada, dès $1.95/mois. Pour une ligne +234 durable, écrivez à [email protected] ; la faisabilité dépend de la réglementation locale.

Les dépenses sont prélevées sur un portefeuille USD prépayé unique, sans forfait ni abonnement mensuel. Rechargez par carte ou en USDT/USDC et recevez une facture PDF pour chaque recharge. Demandez au support de basculer un compte de développement en mode sandbox et votre intégration recevra des numéros et des codes simulés, de quoi tester tout le chemin du webhook sans dépenser de fonds du portefeuille.

Questions fréquentes

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

Oui. Commandez un numéro +234 depuis l'OTP Gateway et lisez le code dans le tableau de bord ou via l'API.

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

Utilisez ng comme valeur de country dans les consultations de prix et les demandes d'activation.

Combien coûte la réception d'un OTP SMS du Nigeria ?

Dès $0.20 par code ; le montant exact dépend du service et est renvoyé par l'endpoint des prix.

Dois-je payer si aucun SMS n'arrive ?

Non. Si rien n'arrive en 20 minutes, ou si vous annulez, la totalité du montant retourne dans le portefeuille.

Comment enregistrer un numéro comme 0803 123 4567 ?

Supprimez le zéro initial et enregistrez +2348031234567, la forme E.164 sans espaces.

Ces numéros peuvent-ils servir pour n'importe quel compte ?

Uniquement pour vos propres produits et comptes légitimes. Respectez les conditions de chaque service et la politique d'utilisation acceptable d'OTP Route ; certains services rejettent purement et simplement les numéros virtuels.

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.