Une checklist pour recevoir les codes SMS Bolt sur des numéros OTP Route

Où Bolt demande-t-il un numéro de téléphone ?

Bolt, l'entreprise de mobilité fondée à Tallinn derrière le VTC, la livraison de repas et de courses et la location de trottinettes, construit ses comptes autour d'un numéro mobile. L'application passager confirme ce numéro par un code SMS à usage unique à l'inscription, et le même type de code réapparaît généralement lorsque quelqu'un se connecte depuis un nouvel appareil ou récupère l'accès. Les produits pour chauffeurs, coursiers et entreprises suivent un schéma similaire.

Pour une entreprise, cela signifie que le numéro de téléphone Bolt est en pratique la clé du compte. Les équipes qui gèrent un compte voyage d'entreprise, vérifient le comportement de leur propre intégration partenaire dans une nouvelle ville, ou veulent garder la SIM personnelle d'un collaborateur hors d'une connexion de travail partagée ont toutes besoin d'un moyen maîtrisé de recevoir ce code.

Checklist avant de commander un numéro Bolt

Passez en revue ces points avant de dépenser quoi que ce soit :

• L'objectif est légitime : le compte appartient à votre organisation ou est un compte de test pour votre propre produit, et les conditions de Bolt l'autorisent.
• Le marché est choisi : le pays du numéro correspond à l'endroit où le compte fonctionnera. Un compte passager enregistré avec le numéro d'un pays et utilisé ailleurs peut se comporter différemment.
• Clé d'API prête : une clé Bearer avec le préfixe or_live_, créée dans la console développeur (jusqu'à 10 par compte).
• Endpoint de webhook testé : abonné à activation.sms_received, avec la vérification de signature activée.
• Portefeuille alimenté : confirmez avec GET /api/v1/balance, ou demandez le mode sandbox pour répéter le parcours avec des numéros simulés.
• Plan de repli convenu : décidez à l'avance ce que fait le test si aucun code ne revient.

Quels pays disposent de routes Bolt ?

Des routes Bolt sont actuellement listées pour 198 pays. Parmi les exemples : l'Estonie, la Lettonie, la Lituanie, la Pologne, la République tchèque, le Portugal, l'Allemagne, la Croatie, Malte, la Géorgie, l'Afrique du Sud, le Nigeria, le Kenya, le Ghana, la Tanzanie et l'Ouganda.

Choisissez le pays délibérément. Les fonctionnalités, les moyens de paiement et les contrôles d'inscription de Bolt diffèrent selon les marchés : un test à Varsovie vous apprend donc peu de chose sur un parcours à Nairobi. La disponibilité par pays change au fil de la journée ; GET /api/v1/prices et le tableau de bord montrent ce qui est actif.

Pas à pas : l'API de code de vérification Bolt

1. Confirmez l'identifiant de service avec GET /api/v1/services ; pour Bolt, c'est bolt.
2. Choisissez l'identifiant de pays dans GET /api/v1/countries, par exemple ee pour l'Estonie.
3. Lisez le prix en direct : GET /api/v1/prices?country=ee&service=bolt.
4. Commandez : POST /api/v1/activations avec {"service": "bolt", "country": "ee"}. Conservez l'identifiant d'activation et le numéro renvoyé.
5. Saisissez le numéro dans l'application Bolt de votre appareil de test et demandez le SMS.
6. Traitez l'événement activation.sms_received. Vérifiez X-OTPRoute-Signature: t=<unix>,v1=<hex> en calculant un HMAC-SHA256 sur <t>.<raw body> avec le secret de l'endpoint, rejetez les horodatages anciens et basez les écritures sur l'identifiant d'activation pour qu'une livraison répétée ne change rien.
7. Si les webhooks ne sont pas envisageables, interrogez GET /api/v1/activations/{id} toutes les quelques secondes, bien en deçà de la limite de 300 requêtes par minute.
8. Appelez POST /api/v1/activations/{id}/cancel si le test est abandonné.

Les détails des endpoints sont dans la documentation de l'API, et sécuriser les webhooks OTP explique la vérification de signature.

Pas à pas : la voie du tableau de bord

Pour une seule vérification SMS Bolt de test ou une configuration de compte ponctuelle, le navigateur suffit. Connectez-vous, ouvrez l'OTP Gateway, sélectionnez Bolt et le marché, vérifiez le prix et confirmez. Copiez le numéro dans l'application, demandez le code, et regardez-le apparaître sur la carte de commande avant la fin du minuteur de 20 minutes.

Dépannage : le code Bolt n'est jamais apparu

Une fenêtre vide ne coûte rien ; lorsque 20 minutes s'écoulent sans SMS, ou si vous annulez, la totalité du montant retourne sur votre portefeuille. Causes courantes et solutions :

• Bolt a refusé le numéro : comme beaucoup de plateformes, il n'accepte pas un numéro virtuel pour l'inscription Bolt sur tous les marchés. Essayez une autre route de pays si votre test le permet, ou une tentative ultérieure.
• Livraison lente : le délai dépend du service et de la route ; laissez donc la fenêtre se terminer avant d'annuler.
• Demandes répétées : appuyer plusieurs fois sur renvoyer ou recommander en boucle peut déclencher la limitation propre à Bolt. Espacez les tentatives.
• Mauvais marché : un numéro d'un pays que Bolt ne dessert pas dans votre scénario de test peut ne jamais être accepté.

Le guide sur le routage par pays pour l'OTP explique comment choisir des solutions de repli.

Quand un Dedicated Number est-il le mieux adapté ?

Un numéro à usage unique convient à une vérification unique. Si un compte Bolt doit se reconnecter des semaines plus tard, par exemple un profil passager de staging que votre équipe QA réutilise, ou une connexion d'exploitation revérifiée sur de nouveaux appareils, le numéro doit rester avec vous. Les Dedicated Numbers le permettent, mais uniquement aux États-Unis et au Canada, à partir de $1.95/mois, avec SMS entrants dans le tableau de bord et transférés vers votre webhook sous la forme number.sms_received. Vérifiez que le marché Bolt du compte accepte un numéro américain ou canadien avant de vous y fier. Voir numéros virtuels pour les détails.

Utiliser les numéros Bolt de façon responsable

Respectez les conditions d'utilisation de Bolt sur chaque marché. Limitez-vous à un compte par personne réelle ou par entreprise, et n'utilisez OTP Route que pour tester vos propres produits ou exploiter des comptes légitimes appartenant à votre organisation ; créer des profils passagers jetables ou récolter des promotions n'est pas un usage acceptable. La politique d'utilisation acceptable d'OTP Route s'applique à chaque commande, et Bolt est une marque de son propriétaire, sans aucune affiliation sous-entendue.

Questions fréquentes

Puis-je recevoir un OTP pour Bolt sans carte SIM locale ?

Oui. Commandez un numéro pour le service bolt dans le bon pays, saisissez-le dans l'application et lisez le code dans votre tableau de bord ou via l'API.

Quel est l'identifiant de service de Bolt dans l'API ?

C'est bolt. Associez-le à un identifiant de pays comme pl ou ke lorsque vous appelez POST /api/v1/activations.

Combien coûte un numéro de vérification Bolt ?

À partir de $0.20 par code. Le montant exact dépend du pays et est renvoyé en direct par GET /api/v1/prices.

Bolt accepte-t-il tous les numéros virtuels ?

Non. Bolt peut rejeter les numéros virtuels sur certains marchés ou parcours, c'est pourquoi un code non livré est remboursé automatiquement.

Quel pays choisir pour un test Bolt ?

Utilisez le pays où le compte sera réellement utilisé, afin que les règles d'inscription, la langue et les moyens de paiement correspondent à ce que voient les vrais utilisateurs.

Puis-je conserver le même numéro pour de futures connexions Bolt ?

Pas avec une activation à usage unique. Pour des connexions répétées, un Dedicated Number aux États-Unis ou au Canada est l'option en libre-service.

Puis-je tester le parcours avant de payer ?

Oui. Demandez le mode sandbox sur un compte de développement pour recevoir des numéros et des codes simulés sans dépenser les fonds du portefeuille.

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.