Wie Teams DiDi-SMS-Codes für Tests und Betrieb empfangen

Die Situation: ein Mobilitätskonto, das an einer einzigen Telefonnummer hängt

DiDi ist eine Fahrdienst- und Mobilitätsplattform und behandelt, wie die meisten Apps dieser Kategorie, die Mobilnummer als Kern eines Kontos. Ein SMS-Code wird typischerweise bei der Registrierung angefordert, wenn sich jemand auf einem neuen Gerät anmeldet und bei der Kontowiederherstellung; auch das Onboarding von Fahrern und Kurieren stützt sich auf dieselbe Prüfung.

Das erzeugt Reibung bei legitimer geschäftlicher Arbeit. Ein Unternehmen mit einem Firmen-Fahrgastkonto möchte es nicht an das private Handy eines einzelnen Mitarbeiters binden. Eine Agentur, die Reisen für Kunden verwaltet, braucht einen Verifizierungsschritt, den auch jemand anderes als der ursprüngliche Anmelder abschließen kann. Ein QA-Team, das ein Produkt mit Anbindung an ein DiDi-Konto baut, will den Ablauf proben, ohne ein privates Handy durchs Büro zu reichen. Eine virtuelle Nummer für DiDi, jeweils einmal pro Verifizierung genutzt, hält diese Schritte aus jeder privaten SIM heraus.

Welche Länder können eine DiDi-Telefonnummer liefern?

Die Route didi umfasst derzeit 198 Länder. Teams beginnen meist mit Märkten, in denen die Nachfrage nach Fahrdiensten hoch ist, etwa Mexiko, Brasilien, Chile, Kolumbien, Peru, Argentinien, Costa Rica, Panama, die Dominikanische Republik, Ecuador, Australien, Neuseeland, Japan und Hongkong.

Wählen Sie das Land bewusst. Ein Fahrgastkonto, das in Santiago genutzt wird, sollte mit einer chilenischen Nummer verifiziert werden, und ein Regressionstest für den mexikanischen Registrierungsbildschirm braucht eine mexikanische. Ein Land der Nummer, das nicht zum Markt des Kontos passt, ist ein häufiger Grund dafür, dass ein Test auf dem Papier besteht, aber an der echten App scheitert. Die vollständige Liste finden Sie unter Länder.

Wie läuft der Ablauf der DiDi-Verifizierungscode-API?

Der DiDi-Ablauf nutzt dieselbe Basis-URL wie jede andere Route, https://otproute.com/api/v1, mit einem or_live_-Schlüssel im Authorization-Header.

1. Fragen Sie GET /api/v1/prices?country=<id>&service=didi ab, um zu sehen, ob die Route offen ist und was sie gerade kostet.
2. Geben Sie die Bestellung mit POST /api/v1/activations auf, mit einem Body wie {"service": "didi", "country": "mx"}.
3. Geben Sie die zurückgegebene Nummer im DiDi-Bildschirm ein, den Sie testen, und fordern Sie die SMS an.
4. Lesen Sie den Code aus dem Webhook oder fragen Sie GET /api/v1/activations/{id} per Polling ab, bis er erscheint.
5. Wird der Test zur Fahrtbuchung mittendrin abgebrochen, geben Sie die Nummer über POST /api/v1/activations/{id}/cancel frei.

Ein Konto kann bis zu 10 Schlüssel und 5 Webhook-Endpunkte haben, innerhalb von 300 Anfragen pro Minute.

Wie sollte ein DiDi-Webhook-Handler geschrieben sein?

Abonnieren Sie activation.sms_received und außerdem activation.expired und activation.cancelled, damit Ihr Test weiß, wann er nicht mehr warten muss. Jede Zustellung trägt X-OTPRoute-Signature: t=<unix>,v1=<hex>; berechnen Sie HMAC-SHA256 über "<t>.<raw body>" mit dem Endpunkt-Secret neu, vergleichen Sie in konstanter Zeit und verwerfen Sie alles mit veraltetem Zeitstempel.

Ereignisse sind auf die Aktivierungs-ID bezogen. Speichern Sie diese ID also bei der Bestellung und behandeln Sie eine zweite Zustellung für dieselbe ID als Nichtstun. Diese Idempotenz ist wichtig, denn ein wiederholter Webhook darf einen DiDi-Code niemals zweimal abschicken. Sind eingehende Webhooks in Ihrer Umgebung unpraktisch, funktioniert auch das Polling des Aktivierungs-Endpunkts. Der Artikel zur webhookbasierten OTP-Erfassung vergleicht beide Ansätze.

Einen DiDi-OTP über das Dashboard empfangen

Betriebsmitarbeitende können die API ganz überspringen. Melden Sie sich an, laden Sie das Wallet auf, öffnen Sie das OTP Gateway, suchen Sie nach DiDi, wählen Sie das Land, das zum Konto passt, und prüfen Sie den angezeigten Preis vor der Bestätigung. Die Nummer erscheint auf einer Aktivierungskarte, und der Code zeigt sich dort, sobald DiDi ihn sendet. Die Aktivierung bleibt 20 Minuten lang offen.

Warum kommt ein DiDi-Code möglicherweise nicht an?

Mehrere gewöhnliche Ursachen erklären eine leere Aktivierung:

• DiDi kann, wie viele Plattformen, virtuelle Nummern auf manchen Routen oder zu manchen Zeiten ablehnen.
• Die Route des gewählten Landes kann ausgelastet sein; die Verfügbarkeit schwankt im Tagesverlauf.
• Die App kann wiederholte Anfragen desselben Geräts oder derselben Sitzung beim Testen drosseln.

Die Abhilfe ist eher geduldig als aggressiv. Lassen Sie das Zeitfenster ablaufen, versuchen Sie es später oder mit einem anderen Land, das noch zum Test passt, und vermeiden Sie das Neubestellen in enger Schleife. Ein Fehlschlag kostet nichts: Schließt das Fenster oder brechen Sie ab, geht der volle Betrag automatisch ans Wallet zurück.

Wann sollte ein DiDi-Konto auf einer Dedicated Number liegen, und welche Regeln gelten?

Eine einmalige Aktivierung eignet sich für eine einzelne Verifizierung. Muss sich dasselbe DiDi-Konto nächsten Monat erneut anmelden, etwa ein Staging-Fahrgastkonto oder ein gemeinsamer Firmen-Login, hält eine Dedicated Number die Leitung unter Ihrer Kontrolle. Sie werden nur in den Vereinigten Staaten und in Kanada angeboten, ab $1.95/month, mit eingehenden SMS im Dashboard und an Ihrem Webhook. Details finden Sie unter virtuelle Nummern.

Nutzen Sie OTP Route nur zum Testen und Betreiben Ihrer eigenen legitimen Produkte und Konten. Beachten Sie die Bedingungen von DiDi, bleiben Sie bei einem Konto pro realer Person oder Unternehmen und denken Sie daran, dass die Acceptable Use Policy von OTP Route gilt. OTP Route ist nicht mit DiDi verbunden, dessen Name eine Marke ihres Inhabers ist.

Häufige Fragen

Wie lautet die Dienst-ID für die DiDi-SMS-Verifizierung zum Testen?

Verwenden Sie didi im Feld service, zusammen mit der Länder-ID des Marktes, den Sie testen.

Kann ich einen DiDi-OTP für ein mexikanisches Konto ohne mexikanische SIM empfangen?

Ja, wenn die Route für Mexiko offen ist: Bestellen Sie eine Nummer mit dem Land mx und dem Dienst didi und lesen Sie den Code dann per API oder im Dashboard.

Zahle ich, wenn DiDi den Code nie sendet?

Nein. Eine Aktivierung ohne SMS innerhalb von 20 Minuten oder eine, die Sie abbrechen, wird dem Wallet vollständig erstattet.

Akzeptiert DiDi jede virtuelle Nummer?

Nicht unbedingt. Manche Routen können abgelehnt werden; versuchen Sie es also später erneut oder nutzen Sie ein anderes passendes Land.

Kann ich die DiDi-Integration testen, ohne Wallet-Guthaben auszugeben?

Ja. Ein Entwicklungskonto kann auf Anfrage auf Sandbox umgestellt werden, das simulierte Nummern und Codes für End-to-End-Tests liefert.

Wie bezahle ich DiDi-Aktivierungen?

Laden Sie ein vorausbezahltes USD-Wallet per Karte oder mit USDT/USDC auf; es gibt keine Monatsgebühr, und jede Aufladung wird mit einer PDF-Rechnung bestätigt. Die aktuellen Preise stehen auf der Preisseite.

Dienstnamen sind Marken ihrer jeweiligen Inhaber. OTP Route steht in keiner Verbindung zu ihnen. Nutzen Sie die Nummern rechtmäßig und beachten Sie die Bedingungen des jeweiligen Dienstes sowie unsere Richtlinie zur akzeptablen Nutzung.