Vérifier des inscriptions +387 quand personne dans l'équipe n'a de SIM bosnienne

Notre version a besoin d'un test +387, mais la SIM est dans un tiroir à Sarajevo. Que faire ?

C'est un blocage fréquent pour les équipes qui livrent dans les Balkans occidentaux. Le chef de produit veut la preuve que les utilisateurs bosniens peuvent s'inscrire, le responsable QA a une ligne de checklist qui dit « vérifier avec un numéro local », et la seule SIM physique +387 appartient à un collègue parti au printemps dernier.

Voici les raisons habituelles qui mènent une équipe à cette situation :

• Un lancement régional couvrant la Bosnie-Herzégovine aux côtés de la Croatie, de la Serbie et du Monténégro, où le parcours d'inscription de chaque marché demande son propre contrôle.
• Les clients de la diaspora. De nombreuses personnes vivant en Allemagne, en Autriche, en Suède et ailleurs gardent un numéro +387 ; un produit fintech ou proche des télécoms peut donc voir des numéros bosniens chez des utilisateurs qui n'ont jamais mis les pieds dans le pays lors de l'inscription.
• La QA de localisation. Le bosniaque, le croate et le serbe sont tous des langues officielles, et les alphabets latin et cyrillique sont tous deux utilisés au quotidien : les textes et la validation des formulaires méritent donc un vrai passage de bout en bout.

Plutôt que de s'envoyer des cartes SIM par la poste, laissez OTP Route gérer le routage OTP : l'OTP Gateway vous remet un numéro +387 pour une seule vérification et renvoie le SMS entrant via une API de vérification par SMS que votre banc de test peut appeler.

Quelles applications et plateformes peuvent envoyer des codes à un numéro de vérification bosnien ?

La couverture est un instantané en direct : voyez donc ceci comme un point de départ plutôt qu'un menu figé. Au moment de la rédaction, les routes de la Bosnie-Herzégovine incluent Viber, WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, Microsoft & Outlook, LinkedIn, Discord, Uber, Amazon et eBay.

Au total, le pays compte plus de 1 600 services. Si vous avez besoin d'un numéro de vérification de Bosnie-Herzégovine pour un service qui ne figure pas ici, consultez d'abord la liste en direct. Viber compte davantage dans les Balkans que dans beaucoup d'autres régions, ce qu'il faut garder en tête si votre propre produit envoie aussi des codes par des canaux de messagerie en plus du SMS. Comme la disponibilité varie au fil de la journée, demandez à l'API les options actuelles plutôt que de coder une liste en dur dans votre suite de tests.

Comment se déroule le flux de l'API OTP pour la Bosnie-Herzégovine, appel par appel ?

Pour les tests bosniens, pointez votre client vers https://otproute.com/api/v1 et transmettez une clé or_live_ comme jeton Bearer. Les clés se créent dans la console Développeur ; un compte peut détenir jusqu'à 10 clés et 5 points de terminaison de webhook, avec un plafond de 300 requêtes par minute.

1. Appelez une fois GET /api/v1/services et GET /api/v1/countries, mettez les identifiants en cache et confirmez que ba figure dans la liste.
2. Vérifiez le coût avec GET /api/v1/prices?country=ba&service=<id> afin que votre tâche consigne le montant exact avant de dépenser.
3. Envoyez POST /api/v1/activations avec {"service": "<id>", "country": "ba"}. La réponse contient l'identifiant d'activation et le numéro +387 à saisir dans l'application testée.
4. Attendez le webhook activation.sms_received, ou interrogez GET /api/v1/activations/{id} à intervalle modéré si votre exécuteur ne peut pas accepter de trafic entrant.
5. Si le test s'interrompt, libérez le numéro avec POST /api/v1/activations/{id}/cancel afin que les fonds reviennent aussitôt.

Pour les webhooks, lisez l'en-tête X-OTPRoute-Signature (t=<unix>,v1=<hex>), calculez le HMAC-SHA256 sur <t>.<raw body> avec le secret du point de terminaison, comparez en temps constant et rejetez les horodatages périmés. Comme les événements sont indexés sur l'identifiant d'activation, un code +387 livré deux fois ne doit être enregistré qu'une seule fois. Le guide d'intégration de l'API OTP détaille davantage les nouvelles tentatives et la gestion des erreurs.

Existe-t-il une solution sans code pour l'équipe support ou opérations ?

Oui. Quelqu'un sans accès à l'API peut faire la même chose depuis le navigateur : se connecter, ouvrir l'OTP Gateway, choisir la Bosnie-Herzégovine et le service, lire le prix, puis confirmer. Le numéro s'affiche à l'écran, et le code apparaît à côté dès réception du SMS. Cela convient à un agent du support qui reproduit un problème d'inscription d'un client, ou à un responsable des opérations qui vérifie un portail partenaire après un changement de téléphone.

Comment stocker les numéros +387 et analyser le texte des SMS bosniens ?

Sur le plan national, les numéros bosniens se composent avec un préfixe interurbain 0, et les mobiles commencent généralement par 06. En E.164, ce zéro disparaît : un numéro écrit localement 061 suivi de six chiffres devient +387 61 plus ces six chiffres. Ne stockez que la forme E.164, retirez les espaces, tirets et barres obliques à la saisie, et rejetez tout ce qui conserve le zéro initial après l'indicatif pays.

Les SMS de vérification peuvent arriver en anglais ou dans l'une des langues locales, et un message rédigé en cyrillique est tout à fait possible. Extrayez le code avec un motif de chiffres plutôt qu'en cherchant un mot précis, et veillez à ce que vos journaux préservent l'UTF-8, afin que les signes diacritiques comme č, ć, š et ž ne soient pas altérés quand vous déboguez une exécution en échec.

Que faire si une exécution de test ne reçoit jamais le code ?

Rien n'est facturé quand un code n'arrive pas. Si aucun SMS n'arrive en 20 minutes, ou si vous annulez avant, le montant intégral retourne automatiquement sur le portefeuille. Dans ce cas :

• Laissez la fenêtre aller à son terme plutôt que de recommander immédiatement ; un SMS tardif compte quand même.
• Réessayez un peu plus tard, ou choisissez la route d'un autre service pour le même scénario.
• Vérifiez que le service cible accepte bien les numéros virtuels ; certains les refusent, et c'est précisément pour cela que le remboursement existe.
• Évitez de commander en boucle serrée depuis la CI, ce qui consomme la limite de débit sans améliorer les chances.

L'article sur la réduction des échecs de livraison OTP présente les pratiques qui ont tendance à aider.

Peut-on garder une ligne bosnienne à long terme, et comment fonctionne la facturation ?

Pas en libre-service. Les Dedicated Virtual Numbers, qui se renouvellent depuis le portefeuille à partir de $1.95/mois, ne sont vendus instantanément que pour les États-Unis et le Canada. Si votre équipe a réellement besoin d'une ligne +387 à long terme, écrivez à [email protected] ; la possibilité dépend de la réglementation locale, et rien ne garantit qu'elle puisse être mise en place.

La facturation de la passerelle repose sur un seul portefeuille prépayé en USD, sans frais mensuels ni formule à choisir. Les fonds peuvent être ajoutés par carte ou en stablecoins USDT/USDC ; une facture PDF pour chaque dépôt arrive dans votre boîte de réception. Pour le travail d'intégration, un compte de développement peut être basculé en sandbox sur demande, renvoyant des numéros et des codes simulés afin que votre pipeline s'exécute sans toucher aux fonds du portefeuille. Les tarifs actuels figurent sur la page des tarifs, et vous pouvez créer un compte avec un code envoyé par e-mail ou une connexion Google.

Questions fréquentes

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

Oui. Commandez un numéro +387 pour votre service via l'OTP Gateway, saisissez-le dans votre application, puis lisez le code dans le tableau de bord ou depuis l'API.

Quel identifiant de pays OTP Route utilise-t-il pour la Bosnie-Herzégovine ?

L'identifiant est ba. Transmettez-le dans le champ country lors de la création d'une activation et comme paramètre de requête country pour consulter les prix.

Dois-je payer si le code +387 n'arrive jamais ?

Non. Si rien n'arrive dans la fenêtre de 20 minutes, ou si vous annulez, le montant intégral retourne automatiquement sur votre portefeuille.

Dois-je conserver le zéro initial en enregistrant un numéro mobile bosnien ?

Non. Enregistrez les numéros en E.164, c'est-à-dire +387 suivi du numéro sans son zéro interurbain national.

Un numéro +387 de test convient-il à un compte auquel nous devrons nous reconnecter le mois prochain ?

Pas vraiment, car chaque numéro de la passerelle ne couvre qu'une seule vérification. Pour des connexions répétées, un Dedicated Number aux États-Unis ou au Canada est l'option en libre-service ; pour une ligne bosnienne à long terme, interrogez l'équipe par e-mail.

Puis-je exécuter des tests OTP bosniens en CI sans dépenser d'argent ?

Oui, en demandant le mode sandbox sur un compte de développement. Il renvoie des numéros et des codes simulés, de sorte que tout le flux, webhooks compris, peut être exercé gratuitement.

Existe-t-il des règles sur l'utilisation de ces numéros ?

Oui. Respectez les conditions de chaque service, n'utilisez les numéros que pour vos propres produits et comptes légitimes, et notez que la politique d'utilisation acceptable d'OTP Route s'applique à chaque commande.

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.