API OTP Samoa : tester les inscriptions +685 à travers le Pacifique

Samoa en bref pour les équipes produit et QA

Samoa est un État indépendant du Pacifique dont les langues officielles sont le samoan et l’anglais. Une importante communauté samoane vit en Nouvelle-Zélande, en Australie et aux États-Unis ; les applications de transfert d’argent, de messagerie et de voyage doivent donc souvent fonctionner pour des utilisateurs qui circulent entre ces pays et leur île d’origine.

Deux particularités méritent d’être connues. D’abord, Samoa (+685) n’est pas les Samoa américaines, qui font partie du plan de numérotation nord-américain sous l’indicatif +1 684 ; confondre les deux dans un sélecteur de pays envoie les codes au mauvais endroit. Ensuite, Samoa est passé à l’ouest de la ligne internationale de changement de date en 2011 et son heure est très en avance sur UTC, ce qui en fait un cas pratique pour tester les limites de dates dans la logique d’expiration.

Pour une équipe produit, Samoa est rarement un marché de lancement à part entière. Il apparaît plutôt dans un déploiement régional dans le Pacifique, comme exigence d’une application tournée vers la diaspora, ou parce qu’une organisation partenaire à Apia doit faire valider un compte professionnel. Dans tous les cas, l’objectif est le même : prouver qu’un utilisateur en +685 peut terminer votre parcours d’inscription.

Comment traiter un numéro +685 dans le code ?

Les numéros nationaux samoans sont courts comparés à ceux de la plupart des marchés ; les validateurs réglés pour des numéros de neuf ou dix chiffres peuvent donc rejeter un numéro réel. Enregistrez les numéros sous la forme +685 suivi des chiffres nationaux, sans séparateurs, et supprimez tout zéro ajouté par habitude. Comme les horodatages des webhooks sont en secondes Unix, comparez-les en UTC plutôt qu’en heure locale ; vous éviterez les mauvaises surprises lorsque votre serveur et un testeur basé à Samoa ne sont pas le même jour du calendrier.

Si votre produit permet de passer d’un numéro néo-zélandais à un numéro samoan sur le même profil, ajoutez un test qui change l’indicatif pays et vérifie que l’ancien état de vérification est effacé, afin qu’un code envoyé à un numéro ne soit jamais accepté pour l’autre.

Quels services sont disponibles sur les routes Samoa ?

Le catalogue Samoa répertorie actuellement plus de 600 services. Parmi les plus demandés figurent WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), Viber, Signal, TikTok, Microsoft & Outlook, Amazon et Discord. La couverture est plus restreinte ici que sur les grands marchés et évolue au fil de la journée ; consultez donc GET /api/v1/services et GET /api/v1/countries avant chaque exécution. Si un service manque, une route voisine comme Fidji ou Tonga peut convenir à votre test.

Ce catalogue plus léger est une bonne raison de rendre votre banc de test tolérant : si le service souhaité est absent au moment de l’exécution, marquez le cas comme ignoré plutôt qu’échoué, et notez-le pour qu’un collègue puisse le relancer plus tard.

Demander un code Samoa via l’API

Avec une clé Bearer (or_live_…) sur https://otproute.com/api/v1, consultez le prix via GET /api/v1/prices?country=ws&service=<id>, puis envoyez {"service": "<id>", "country": "ws"} à POST /api/v1/activations. Suivez l’identifiant d’activation en interrogeant GET /api/v1/activations/{id} ou en écoutant activation.sms_received. Vérifiez le HMAC X-OTPRoute-Signature sur chaque webhook, refusez les horodatages périmés et rendez votre gestionnaire sûr à exécuter deux fois pour la même activation. Le guide d’intégration en montre le schéma complet.

Les limites de débit sont confortables pour un marché de cette taille : chaque compte dispose de 10 clés, 5 points de terminaison webhook et 300 requêtes par minute. Si vous interrogez l’API, quelques secondes entre deux vérifications suffisent largement.

Le faire à la main dans le tableau de bord

1. Connectez-vous et ouvrez l’OTP Gateway.
2. Choisissez le service, puis Samoa.
3. Vérifiez le prix affiché en direct et confirmez.
4. Collez le numéro +685 dans l’application testée et demandez le code.
5. Lisez le code à l’écran, ou annulez si vous n’en avez plus besoin.

Quand un code +685 est lent ou absent

Laissez l’activation ouverte pendant les 20 minutes complètes avant d’abandonner. Certaines applications refusent purement et simplement les numéros virtuels, et c’est précisément pour cela que les commandes sans réponse sont remboursées. Si une route reste silencieuse, réessayez plus tard ou choisissez une autre route de service ; enchaîner de nouvelles commandes en boucle serrée aide rarement et épuise votre limite de débit.

Consignez l’identifiant d’activation à chaque tentative afin de voir si le silence vient d’une application en particulier ou de la route dans son ensemble.

Numéros long terme et paiement à l’usage

OTP Route ne vend pas de numéro samoan long terme en libre-service. Les Dedicated Numbers démarrent à partir de $1.95/mois et sont limités aux États-Unis et au Canada ; pour une ligne à Samoa, écrivez à [email protected], sans promesse que cela puisse être organisé. Le portefeuille prépayé en USD accepte les cartes et l’USDT/USDC, envoie une facture PDF par recharge et n’entraîne aucun abonnement mensuel. Demandez le mode sandbox sur un compte de développement pour répéter le flux ws sans dépenser de fonds.

Questions fréquentes

Samoa est-il la même chose que les Samoa américaines pour les numéros de téléphone ?

Non. Samoa utilise +685, tandis que les Samoa américaines utilisent +1 684. Choisissez le bon dans votre sélecteur de pays et dans l’API.

Quel est l’identifiant de pays de l’API pour Samoa ?

Utilisez ws dans la requête de prix et dans la demande d’activation.

Combien coûte un code de vérification Samoa ?

À partir de $0.20 par code ; le prix exact dépend du service et s’affiche avant la commande.

Puis-je tester l’inscription d’un utilisateur samoan depuis la Nouvelle-Zélande ou l’Australie ?

Oui. Le numéro +685 reçoit le SMS et OTP Route vous l’affiche où que travaille votre équipe.

Paie-t-on quand aucun message n’arrive ?

Non. Les activations expirées ou annulées sont remboursées automatiquement sur le portefeuille.

Dans quelles langues arrivent les codes Samoa ?

En général en anglais, qui est officiel au même titre que le samoan. Analysez les chiffres, pas le texte qui les entoure.

Puis-je utiliser ces numéros pour ouvrir de nombreux comptes ?

Non. Respectez les conditions de chaque service ; la politique d’utilisation acceptable limite OTP Route aux tests et à l’exploitation de vos propres comptes et produits 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.