Check-list avant décollage pour recevoir des codes de vérification +375 de Biélorussie

Que faut-il avoir en place avant de demander un numéro +375 ?

Avant d'utiliser un numéro +375 pour des tests, cochez ces points :

• Un compte et un portefeuille approvisionné. Créez-en un sur /signup avec une adresse e-mail et un code e-mail à 6 chiffres, ou avec la connexion Google, puis ajoutez un petit solde. Activez l'authentification à deux facteurs TOTP sur le compte qui détient les clés API.
• Une clé Bearer avec le préfixe or_live_, créée dans la console développeur. Donnez des clés distinctes à la CI et au développement local ; un compte peut en détenir jusqu'à 10.
• Les deux identifiants que vous enverrez. La Biélorussie est by dans l'API, et l'identifiant de service est la valeur api_service renvoyée par GET /api/v1/services.
• Un endpoint de réception si vous prévoyez d'utiliser des webhooks, avec son secret de signature stocké hors du dépôt.
• Un compte de test dans votre propre produit autorisé à modifier ou ajouter un numéro de téléphone.
• Une bibliothèque de numéros configurée pour la région BY, afin que le numéro collé dans votre formulaire d'inscription soit analysé comme le saisirait un véritable utilisateur biélorusse.

Comment écrit-on les numéros biélorusses, et comment votre application doit-elle les stocker ?

La Biélorussie utilise l'indicatif +375 suivi d'un numéro national à neuf chiffres. Les lignes mobiles commencent par des codes d'opérateur tels que 25, 29, 33 ou 44 ; une valeur stockée ressemble donc à +37529XXXXXXX.

Le piège tient à l'habitude nationale. À l'intérieur du pays, on écrit souvent un mobile avec un 80 initial, comme dans 8 029 XXX-XX-XX, qui provient du préfixe de numérotation longue distance. Ce 80 doit être supprimé avant d'ajouter l'indicatif pays ; un formulaire qui le conserve produit une chaîne E.164 invalide que certains services de vérification rejettent silencieusement. De bons tests de normalisation pour un numéro de vérification biélorusse :

• acceptez +375 29 ..., 375 29 ... et 8 029 ... et stockez les trois de façon identique ;
• affichez le numéro avec un groupement adapté au local, mais n'envoyez que du E.164 à votre couche SMS ou de vérification ;
• rejetez un numéro qui garde encore 80 après le 375.

Le biélorusse et le russe sont tous deux langues officielles, et c'est le russe que la plupart des gens utilisent au quotidien. De nombreux services envoient le texte de leur code en russe ou en anglais selon la locale du compte ; vérifiez donc que votre application affiche correctement le cyrillique sur tout écran qui reprend le message.

Pour quels services un numéro de vérification biélorusse peut-il recevoir des codes ?

Le routage OTP pour la Biélorussie sur OTP Route couvre actuellement plus de 1 400 services sous l'identifiant by. Parmi les routes populaires du relevé actuel : Telegram, Viber, WhatsApp, Signal, Google (Gmail & YouTube), Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Amazon et AliExpress.

La disponibilité de chaque route évolue dans la journée ; considérez donc une liste comme celle-ci comme un point de départ plutôt que comme une promesse. Avant une exécution, interrogez GET /api/v1/prices?country=by&service=<id> pour connaître le prix actuel et savoir si la route peut accepter une commande maintenant. Voir le routage OTP par pays pour choisir entre plusieurs pays.

Pas à pas : le flux de l'API OTP Biélorussie depuis un script de test

Chaque requête va vers https://otproute.com/api/v1 avec votre clé Bearer. L'API de vérification par SMS est assez petite pour tenir dans une seule fonction utilitaire :

1. Appelez GET /api/v1/balance et arrêtez la tâche tôt si le portefeuille est trop bas pour la suite de tests.
2. Appelez GET /api/v1/prices?country=by&service=telegram (remplacez par votre identifiant de service) et journalisez le prix que vous allez payer.
3. Créez la commande avec POST /api/v1/activations et un corps du type {"service": "telegram", "country": "by"}. Conservez l'identifiant d'activation et le numéro +375 de la réponse.
4. Soumettez ce numéro à l'étape téléphone de votre propre application et déclenchez le code.
5. Récupérez le code depuis un événement activation.sms_received, ou interrogez GET /api/v1/activations/{id}. La limite est de 300 requêtes par minute.
6. Si le test est interrompu, appelez POST /api/v1/activations/{id}/cancel pour que la somme retenue retourne aussitôt au portefeuille.

Pour les webhooks, lisez l'en-tête X-OTPRoute-Signature (t=<unix>,v1=<hex>), calculez le HMAC-SHA256 de <t>.<raw body> avec le secret du endpoint, comparez en temps constant et rejetez les livraisons dont l'horodatage est périmé. Indexez votre gestionnaire sur l'identifiant d'activation pour qu'une livraison répétée reste sans effet. La documentation de l'API et le guide pour sécuriser les webhooks OTP avec HMAC donnent les détails.

Pas à pas : la même tâche depuis le tableau de bord

Le personnel du support qui a besoin d'un code de temps à autre peut se passer de l'API :

1. Ouvrez l'OTP Gateway dans le tableau de bord et choisissez la Biélorussie.
2. Sélectionnez le service ; le prix de cette route s'affiche avant que vous ne confirmiez.
3. Copiez le numéro +375 et saisissez-le dans l'application testée.
4. Surveillez la carte de commande. Le code y apparaît dès qu'il arrive.

Si rien n'arrive en 20 minutes, la commande se ferme et le montant total est recrédité. Vous ne payez que lorsqu'un code est livré.

Dépannage : le code +375 n'est pas arrivé

Les causes habituelles et la suite à donner à chacune :

• Le service a refusé le numéro. Certaines plateformes rejettent les numéros virtuels. La règle de remboursement existe pour ce cas précis ; essayez une autre route de service ou un autre pays si le test le permet.
• Le numéro a été saisi sous sa forme nationale. Vérifiez que votre formulaire a bien envoyé +375 plus neuf chiffres, sans le 80.
• La route est occupée. Laissez la fenêtre aller à son terme au lieu d'annuler après une minute, puis réessayez plus tard.
• Votre script recommande en boucle serrée. Ajoutez un délai entre les tentatives ; des commandes répétées en rafale sur un même service aident rarement et peuvent ressembler à un abus pour la plateforme cible.

D'autres schémas d'échec pour les commandes +375 sont traités dans réduire les échecs de livraison OTP.

Existe-t-il une ligne biélorusse longue durée, et comment fonctionne la facturation ?

Non. OTP Route ne propose pas de numéro longue durée en libre-service pour la Biélorussie. Si votre équipe en a besoin pour un cas d'usage opérationnel ou de support, écrivez à [email protected] en le décrivant ; ce qui peut être proposé dépend de la réglementation locale, et rien n'est promis. Les Numéros virtuels dédiés sont un produit américain et canadien, à partir de $1.95/mois, avec SMS entrants, SMS sortants et appels depuis le navigateur.

Les commandes biélorusses puisent dans le même portefeuille prépayé en USD que toutes les autres routes, sans frais mensuels et sans formule à choisir. Alimentez-le par carte ou en stablecoins USDT/USDC ; une facture PDF pour chaque recharge arrive dans votre boîte de réception. Les développeurs peuvent demander un compte sandbox qui renvoie des numéros et des codes simulés, le moyen le moins coûteux de valider une intégration avant de passer de vraies commandes. N'utilisez chaque numéro que pour votre propre produit ou vos propres comptes légitimes, respectez les conditions de chaque service, et notez que la politique d'utilisation acceptable d'OTP Route s'applique. Les montants actuels figurent sur la page des tarifs.

Questions fréquentes

Puis-je tester le parcours d'inscription de mon application en Biélorussie sans carte SIM locale ?

Oui. Commandez un numéro +375 pour votre service sur l'OTP Gateway, soumettez-le dans votre formulaire d'inscription et lisez le code dans le tableau de bord ou via l'API.

Quel est l'identifiant de pays de la Biélorussie dans l'API OTP Route ?

C'est by. Utilisez-le dans GET /api/v1/prices et dans le corps de POST /api/v1/activations.

Dois-je stocker les numéros biélorusses avec le préfixe 80 ?

Non. Stockez-les en E.164 sous la forme +375 suivi de neuf chiffres et supprimez le 80 national, sinon de nombreux services considéreront le numéro comme invalide.

Que devient mon argent si le numéro +375 ne reçoit aucun code ?

Lorsque la fenêtre de 20 minutes se termine sans SMS, ou si vous annulez, le montant total est restitué automatiquement à votre portefeuille.

Dans quelle langue sera le SMS de vérification ?

C'est le service expéditeur qui en décide. Pour les numéros biélorusses, c'est souvent le russe ou l'anglais, selon la langue du compte ou de l'appareil.

Puis-je conserver un numéro +375 pour de futures connexions ?

Pas en libre-service. Les Numéros dédiés longue durée n'existent que pour les États-Unis et le Canada ; pour la Biélorussie, vous pouvez écrire à [email protected] pour demander, sans promesse de disponibilité.

Existe-t-il un moyen de tester l'intégration sans dépenser les fonds du portefeuille ?

Oui. Un compte de développement peut passer en sandbox sur demande ; il renvoie 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.