Tester les parcours de vérification +27 : une checklist pour les lancements en Afrique du Sud

Avant la première commande +27 : une courte liste de préparation

Cochez ces points et votre première activation sud-africaine devrait se dérouler sans surprise :

1. Portefeuille rechargé. Un portefeuille prépayé unique en USD finance tout ; alimentez-le par carte ou en USDT/USDC. Aucun abonnement n'est impliqué.
2. Clé émise. Générez une clé Bearer dans la console Développeur (elle commence par or_live_). Gardez des clés séparées pour la CI et pour le staging, jusqu'à 10 au total.
3. Webhook enregistré. Ajoutez un endpoint HTTPS et conservez son secret de signature. Vous pouvez en enregistrer jusqu'à cinq.
4. Normaliseur de numéros testé. Donnez-lui une saisie du type 082 123 4567 et vérifiez qu'il produit +2782... sans le 0 initial.
5. Identifiant de service confirmé. Récupérez le catalogue avec GET /api/v1/services plutôt que de deviner les identifiants.
6. Sandbox facultatif. Le support peut basculer un compte de développement en sandbox pour que des numéros et des codes simulés traversent votre code avant toute dépense réelle.

Le guide des tests CI montre comment brancher ces éléments dans un pipeline.

Comment stocker et normaliser les numéros sud-africains ?

L'Afrique du Sud utilise le préfixe de ligne 0. Un mobile écrit en local compte dix chiffres, comme 082 123 4567, et les plages mobiles commencent généralement par 06, 07 ou 08 dans cette forme nationale. En format international, le 0 disparaît : la même ligne devient +27 82 123 4567, soit +27821234567 une fois les espaces retirés, ce qui fait neuf chiffres après l'indicatif.

Le bug classique est une valeur stockée du type +270821234567, produite quand un formulaire colle l'indicatif au numéro local sans retirer le 0. Normalisez à la saisie, ne stockez que du E.164 et affichez le format local espacé uniquement pour l'affichage. Si vous envoyez vous-même des SMS sortants, la même règle garde cohérents les rapports de livraison et les recherches d'utilisateurs.

Quels services peuvent envoyer des codes vers un numéro de vérification sud-africain ?

Parmi les routes populaires pour za en ce moment : WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Uber, Telegram, Microsoft & Outlook, LinkedIn, Netflix, Amazon, X (Twitter), ChatGPT (OpenAI) et Discord. Sur l'ensemble du catalogue, le pays prend en charge plus de 1 700 services ; le stock bougeant au fil de la journée, c'est l'API qu'il faut lire pour la disponibilité actuelle.

Pourquoi les équipes choisissent-elles ce marché ? Johannesburg et Le Cap sont des pôles technologiques et financiers établis, et de nombreuses entreprises font de l'Afrique du Sud la base d'un déploiement plus large en Afrique australe. Le pays compte plusieurs langues officielles, dont l'anglais, l'isiZulu, l'isiXhosa et l'afrikaans, mais la plupart des messages de vérification arrivent en anglais ; la QA de localisation se concentre donc plutôt sur les écrans environnants que sur le texte du SMS.

Étapes : appeler l'API OTP Afrique du Sud depuis votre banc de test

Les requêtes vont à https://otproute.com/api/v1 avec votre clé Bearer, dans la limite de 300 par minute.

1. GET /api/v1/prices?country=za&service=<id> renvoie le prix en direct de l'association voulue.
2. POST /api/v1/activations avec {"service": "<id>", "country": "za"} réserve un numéro +27 et renvoie un identifiant d'activation.
3. Votre test saisit le numéro dans l'application et déclenche le SMS.
4. L'événement activation.sms_received parvient à votre webhook. Avant de lui faire confiance, reconstruisez le HMAC-SHA256 de <t>.<raw body> avec le secret de l'endpoint, comparez-le au v1 de X-OTPRoute-Signature et écartez les requêtes dont l'horodatage est trop ancien.
5. Vous préférez le polling ? Lisez GET /api/v1/activations/{id} à intervalle raisonnable.
6. Les exécutions abandonnées doivent appeler POST /api/v1/activations/{id}/cancel, et GET /api/v1/balance permet à un job de s'arrêter tôt quand les fonds baissent.

Davantage sur les choix de routage dans le routage par pays pour les OTP.

Étapes pour le personnel d'exploitation avec le tableau de bord

Aucun code requis : ouvrez l'OTP Gateway, choisissez l'Afrique du Sud et le service, vérifiez le prix affiché, confirmez, puis collez le numéro +27 dans l'application. Le SMS apparaît sur la page de l'activation dès son arrivée, et la fenêtre de 20 minutes ainsi que le remboursement automatique fonctionnent exactement comme via l'API.

Dépanner les codes sud-africains bloqués

D'abord, côté argent : si aucun SMS n'arrive dans les 20 minutes, ou si vous annulez, le montant complet retourne automatiquement dans le portefeuille. Ensuite, diagnostiquez :

• La patience d'abord. La vitesse de livraison dépend du service et de la route ; laissez donc l'activation aller à son terme.
• Politique d'acceptation. Certains services refusent les numéros virtuels ; un remboursement dans ce cas est un comportement attendu, pas une panne.
• Autre moment ou autre route. Réessayez plus tard, ou utilisez une route voisine comme la Namibie ou le Botswana quand le cas de test le permet.
• Pas de martèlement. Annuler puis recommander en boucle serrée aide rarement et entame votre limite de requêtes.

N'utilisez les numéros que pour tester votre propre produit ou exploiter vos propres comptes professionnels, respectez les conditions de chaque service, et gardez à l'esprit que la politique d'utilisation acceptable d'OTP Route s'applique.

Lignes sud-africaines longue durée et modèle de facturation

Il n'existe pas de numéro +27 longue durée en libre-service. Les Numéros Dédiés, à partir de $1.95/mois, ne sont proposés qu'aux États-Unis et au Canada ; les équipes qui ont besoin d'une ligne sud-africaine permanente peuvent écrire à [email protected], et la faisabilité dépend de la réglementation locale. La facturation est à l'usage depuis le portefeuille prépayé, avec une facture PDF envoyée par e-mail pour chaque recharge. Consultez les tarifs pour le tableau complet.

Questions fréquentes

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

Oui. Commandez un numéro +27 via l'OTP Gateway et lisez le code dans le tableau de bord ou via l'API. Cela coûte à partir de $0.20 par code, et seulement quand le code arrive.

Dois-je garder le 0 initial en convertissant un numéro sud-africain en E.164 ?

Non. Supprimez le 0 de ligne et ajoutez le préfixe +27 : 082 123 4567 devient +27821234567.

Quel est l'identifiant de pays de l'Afrique du Sud dans l'API ?

C'est za, à indiquer dans la requête de prix et dans le corps JSON lorsque vous créez une activation +27.

Dans quelle langue sont rédigés les SMS de vérification sud-africains ?

Surtout en anglais, bien que le pays ait plusieurs langues officielles. La formulation est décidée par le service expéditeur.

Y a-t-il un remboursement si le code n'est jamais livré ?

Oui. L'activation reste ouverte 20 minutes, et si rien n'arrive ou si vous annulez, le montant complet retourne automatiquement dans votre portefeuille.

Puis-je acheter un numéro sud-africain à garder pendant des mois ?

Pas en libre-service. Les Numéros Dédiés sont un produit réservé aux États-Unis et au Canada ; pour l'Afrique du Sud, écrivez au support pour vous renseigner, sans promesse de disponibilité.

Combien de services puis-je vérifier avec un numéro +27 sur OTP Route ?

Plus de 1 700 au dernier instantané. Consultez le catalogue en direct via l'API, car la disponibilité change au fil de la journée.

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.