Comment les équipes reçoivent les codes SMS DiDi pour les tests et l'exploitation

La situation : un compte de mobilité suspendu à un seul numéro de téléphone

DiDi est une plateforme de VTC et de mobilité, et comme la plupart des applications de cette catégorie, elle traite le numéro mobile comme le cœur d'un compte. Un code SMS est généralement demandé à l'inscription, lors d'une connexion sur un nouvel appareil et pendant la récupération du compte ; l'intégration des chauffeurs et des coursiers repose sur le même contrôle.

Cela crée des frictions pour un travail professionnel légitime. Une entreprise qui gère un compte passager d'entreprise ne veut pas qu'il soit lié au téléphone personnel d'un seul employé. Une agence qui gère les déplacements de clients a besoin d'une étape de vérification qu'une autre personne que le signataire d'origine peut effectuer. Une équipe QA qui construit un produit lié à un compte DiDi veut répéter le parcours sans faire circuler un mobile personnel dans les bureaux. Un numéro virtuel pour DiDi, utilisé une fois par vérification, garde ces étapes hors de la SIM privée de quiconque.

Quels pays peuvent fournir un numéro de téléphone DiDi ?

La route didi couvre actuellement 198 pays. Les équipes commencent le plus souvent par des marchés où la demande de VTC est forte, comme le Mexique, le Brésil, le Chili, la Colombie, le Pérou, l'Argentine, le Costa Rica, le Panama, la République dominicaine, l'Équateur, l'Australie, la Nouvelle-Zélande, le Japon et Hong Kong.

Choisissez le pays délibérément. Un compte passager qui sera utilisé à Santiago doit être vérifié avec un numéro chilien, et un test de régression de l'écran d'inscription mexicain exige un numéro mexicain. Désaccorder le pays du numéro et le marché du compte est une cause fréquente de test qui passe sur le papier mais échoue face à la vraie application. La liste complète se trouve sous pays.

Comment se déroule le flux de l'API de code de vérification DiDi ?

Le flux DiDi utilise la même URL de base que toutes les autres routes, https://otproute.com/api/v1, avec une clé or_live_ dans l'en-tête Authorization.

1. Interrogez GET /api/v1/prices?country=<id>&service=didi pour savoir si la route est ouverte et ce qu'elle coûte à l'instant.
2. Passez la commande avec POST /api/v1/activations et un corps tel que {"service": "didi", "country": "mx"}.
3. Saisissez le numéro renvoyé sur l'écran DiDi que vous testez et demandez le SMS.
4. Lisez le code depuis le webhook, ou interrogez GET /api/v1/activations/{id} jusqu'à son apparition.
5. Si le test de réservation de course est abandonné en cours de route, libérez le numéro via POST /api/v1/activations/{id}/cancel.

Un compte peut détenir jusqu'à 10 clés et 5 endpoints de webhook, dans la limite de 300 requêtes par minute.

Comment écrire un gestionnaire de webhook DiDi ?

Abonnez-vous à activation.sms_received, ainsi qu'à activation.expired et activation.cancelled pour que votre test sache quand cesser d'attendre. Chaque livraison porte X-OTPRoute-Signature: t=<unix>,v1=<hex> ; recalculez le HMAC-SHA256 sur "<t>.<raw body>" avec le secret de l'endpoint, comparez en temps constant et écartez tout ce qui a un horodatage périmé.

Les événements sont associés à l'identifiant d'activation : stockez donc cet identifiant à la commande et traitez une seconde livraison pour le même identifiant comme une opération sans effet. Cette idempotence est importante, car un webhook rejoué ne doit jamais soumettre deux fois un code DiDi. Si les webhooks entrants sont délicats dans votre environnement, le polling de l'endpoint d'activation fonctionne aussi. L'article sur la capture d'OTP par webhook compare les deux approches.

Recevoir un OTP DiDi depuis le tableau de bord

Le personnel d'exploitation peut se passer totalement de l'API. Connectez-vous, rechargez le portefeuille, ouvrez l'OTP Gateway, recherchez DiDi, choisissez le pays qui correspond au compte et vérifiez le prix affiché avant de confirmer. Le numéro apparaît sur une carte d'activation, et le code s'y affiche dès que DiDi l'envoie. L'activation reste ouverte 20 minutes.

Pourquoi un code DiDi pourrait-il ne pas arriver ?

Plusieurs causes ordinaires expliquent une activation vide :

• DiDi, comme beaucoup de plateformes, peut refuser les numéros virtuels sur certaines routes ou à certains moments.
• La route du pays choisi peut être chargée ; la disponibilité évolue tout au long de la journée.
• L'application peut limiter les demandes répétées depuis le même appareil ou la même session pendant les tests.

Le remède est la patience plutôt que l'agressivité. Laissez la fenêtre se terminer, réessayez plus tard ou avec un autre pays qui convient toujours au test, et évitez de recommander en boucle serrée. Vous ne payez jamais un échec : à la fin de la fenêtre ou à l'annulation, la totalité du montant retourne automatiquement sur le portefeuille.

Quand un compte DiDi doit-il reposer sur un Dedicated Number, et quelles règles s'appliquent ?

Une activation à usage unique convient à une seule vérification. Si le même compte DiDi doit se reconnecter le mois prochain, par exemple un compte passager de staging ou une connexion d'entreprise partagée, un Dedicated Number garde la ligne sous votre contrôle. Ils ne sont proposés qu'aux États-Unis et au Canada, à partir de $1.95/mois, avec SMS entrants dans le tableau de bord et sur votre webhook. Voir numéros virtuels pour les détails.

N'utilisez OTP Route que pour tester et exploiter vos propres produits et comptes légitimes. Respectez les conditions de DiDi, limitez-vous à un compte par personne réelle ou par entreprise, et notez que la politique d'utilisation acceptable d'OTP Route s'applique. OTP Route n'a aucune affiliation avec DiDi, dont le nom est une marque de son propriétaire.

Questions fréquentes

Quel est l'identifiant de service pour la vérification SMS DiDi en test ?

Utilisez didi dans le champ service, avec l'identifiant de pays du marché que vous testez.

Puis-je recevoir un OTP DiDi pour un compte mexicain sans carte SIM mexicaine ?

Oui, si la route du Mexique est ouverte : commandez un numéro avec le pays mx et le service didi, puis lisez le code par API ou dans le tableau de bord.

Est-ce que je paie si DiDi n'envoie jamais le code ?

Non. Une activation sans SMS dans les 20 minutes, ou que vous annulez, est remboursée intégralement sur le portefeuille.

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

Pas nécessairement. Certaines routes peuvent être refusées : réessayez plus tard ou utilisez un autre pays adapté.

Puis-je tester l'intégration DiDi sans dépenser les fonds du portefeuille ?

Oui. Un compte de développement peut passer en sandbox sur demande, avec des numéros et des codes simulés pour des tests de bout en bout.

Comment payer les activations DiDi ?

Rechargez un portefeuille prépayé en USD par carte ou en USDT/USDC ; il n'y a pas d'abonnement mensuel, et chaque recharge est accompagnée d'une facture PDF. Les tarifs actuels figurent sur la page tarifs.

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.