Automatiser la vérification SMS +260 pour vos tests d'inscription zambiens

Quels endpoints une intégration de l'API OTP Zambie appelle-t-elle ?

L'intégration est une courte chaîne d'appels HTTPS vers https://otproute.com/api/v1, chacun portant Authorization: Bearer avec une clé préfixée or_live_. L'identifiant de pays de la Zambie est zm.

• GET /api/v1/countries et GET /api/v1/services : données de référence, que l'on peut mettre en cache pour une journée.
• GET /api/v1/prices?country=zm&service=<id> : prix en direct, et indication de la capacité de cette route à prendre une commande à cet instant.
• POST /api/v1/activations avec {"service": "whatsapp", "country": "zm"} : renvoie l'identifiant d'activation et un numéro +260.
• GET /api/v1/activations/{id} : statut et, une fois reçu, le code.
• POST /api/v1/activations/{id}/cancel : rendez le numéro plus tôt.
• GET /api/v1/balance : lancez-le en premier pour qu'une suite de tests s'arrête vite sur un portefeuille vide.

Générez les clés dans la console Développeur, jusqu'à 10 par compte ; une clé par environnement est un schéma bien rangé. La limite du compte est de 300 requêtes par minute. Les schémas complets se trouvent dans la documentation de l'API.

Comment écrire le webhook qui reçoit les codes +260 ?

Le polling fonctionne, mais dès que plusieurs activations tournent en même temps, un webhook est plus propre. Ajoutez jusqu'à 5 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>. Construisez la chaîne <t>.<raw body>, calculez le HMAC-SHA256 avec le secret de l'endpoint et comparez à v1 en temps constant. Utilisez les octets bruts tels que reçus, refusez les horodatages de plus de quelques minutes, et enregistrez les résultats sous l'identifiant d'activation pour qu'une livraison rejouée ne change rien. Répondez vite par un 2xx et faites le travail lent ensuite. Notre guide sur la sécurisation des webhooks OTP avec HMAC donne plus de détails, et les tests OTP par SMS dans les pipelines CI montrent où cela s'insère dans un build.

De quels services un numéro de vérification zambien peut-il recevoir des codes ?

L'instantané en direct place la Zambie à plus de 1 100 services. Parmi eux : WhatsApp, Facebook, Google (Gmail & YouTube), Telegram, Instagram, TikTok, X (Twitter), LinkedIn, Uber, imo, Microsoft & Outlook, Amazon et Netflix. Comme les routes changent d'une heure à l'autre, laissez le endpoint de prix dire à votre code ce qui est ouvert avant de commander.

Format des numéros zambiens et langues des codes reçus

Les numéros zambiens se composent au niveau national avec un préfixe de ligne 0, puis neuf chiffres. Au format international, le zéro disparaît, ce qui donne +260 suivi de neuf chiffres. Normalisez tout dans cette forme E.164 avant d'enregistrer, et assurez-vous que votre champ de saisie accepte à la fois le style local que les utilisateurs tapent réellement et le style international.

L'anglais est la langue officielle, et des langues comme le bemba, le nyanja, le tonga et le lozi sont très parlées. Les SMS de vérification arrivent normalement en anglais, ce qui simplifie l'analyse, mais reposez-vous quand même sur les chiffres pour qu'un changement de formulation de l'expéditeur ne casse pas vos tests.

Les équipes testent sur la Zambie quand elles s'étendent en Afrique australe, conçoivent l'intégration de produits d'argent mobile ou de crédit, ou assistent des clients depuis un centre d'exploitation régional. La page d'intégration fintech couvre ce scénario.

Peut-on faire la même chose depuis le tableau de bord ?

Oui, et c'est pratique pour les vérifications ponctuelles. Connectez-vous, ouvrez l'OTP Gateway, choisissez le service et la Zambie, regardez le prix affiché, puis commandez. Saisissez le numéro +260 dans l'application ; le code apparaît dans le tableau de bord à son arrivée. Annulez une activation dont vous ne voulez plus et son montant retourne sur le portefeuille.

Que faire si le code n'arrive pas, et quand une ligne dédiée est-elle préférable ?

Les activations durent 20 minutes et vous ne payez que lorsque le code arrive. Si la fenêtre expire ou si vous annulez, le montant total retourne automatiquement. Certains services refusent les numéros virtuels, ce qui est la raison du remboursement. Quand un code +260 est lent : attendez la fin de la fenêtre, réessayez plus tard ou avec une autre route de service, vérifiez que le service accepte les numéros virtuels, et évitez de recommander en boucle serrée.

Pour un compte qui doit se reconnecter ou récupérer son accès plus tard, un numéro à usage unique n'est pas le bon outil. Les numéros virtuels dédiés remplissent ce rôle, mais seulement aux États-Unis et au Canada, à partir de $1.95/month. OTP Route n'a pas de ligne zambienne longue durée en libre-service ; si vous avez un vrai besoin, écrivez à [email protected], en gardant à l'esprit que la réglementation locale décide et que rien n'est assuré.

N'utilisez les numéros que pour vos propres produits et comptes légitimes, respectez les conditions de chaque service et rappelez-vous que la politique d'utilisation acceptable d'OTP Route s'applique.

Comment une intégration zambienne est-elle facturée et testée en toute sécurité ?

Un seul portefeuille USD prépayé finance tout ; il n'y a ni abonnement mensuel ni formule. Rechargez par carte ou en USDT/USDC et recevez à chaque fois une facture PDF par e-mail. Pendant le développement, demandez le mode sandbox pour votre compte de développement : des numéros et des codes simulés vous permettent de répéter tout le parcours de routage OTP sans dépense sur le portefeuille. Les tarifs en vigueur sont sur la page de tarification.

Questions fréquentes

Quel identifiant de pays OTP Route utilise-t-il pour la Zambie ?

zm, comme dans POST /api/v1/activations avec {"service": "telegram", "country": "zm"}.

Puis-je recevoir des codes SMS OTP de Zambie sans carte SIM zambienne ?

Oui. L'OTP Gateway fournit un numéro +260 pour les tests, et le code vous parvient dans le tableau de bord, par webhook ou par polling.

Comment stocker correctement les numéros +260 ?

Retirez le préfixe de ligne national 0 et enregistrez +260 plus neuf chiffres en E.164. Formatez séparément pour l'affichage.

L'argent est-il remboursé si WhatsApp ou un autre service rejette le numéro ?

Oui. Quand aucun code n'arrive dans les 20 minutes, ou si vous annulez, le montant est automatiquement recrédité sur votre portefeuille.

Puis-je garder un numéro zambien pour de futures connexions ?

Pas en libre-service. Les numéros longue durée sont un produit États-Unis et Canada ; écrivez à [email protected] pour vous renseigner sur la Zambie, sans aucune promesse.

Puis-je essayer l'intégration avant de payer de vrais codes ?

Oui. Demandez le mode sandbox sur un compte de développement pour obtenir des numéros et des codes simulés pour des tests de bout en bout.

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.