Checkliste für den Empfang von Bolt-SMS-Codes auf OTP-Route-Nummern

Wo fragt Bolt nach einer Telefonnummer?

Bolt, das in Tallinn gegründete Mobilitätsunternehmen hinter Fahrdienst, Essens- und Lebensmittellieferung und Scooter-Verleih, baut seine Konten um eine Mobilnummer herum auf. Die Fahrgast-App bestätigt diese Nummer bei der Registrierung mit einem SMS-Einmalcode, und derselbe Codetyp erscheint typischerweise erneut, wenn sich jemand auf einem neuen Gerät anmeldet oder den Zugang wiederherstellt. Die Produkte für Fahrer, Kuriere und Unternehmen folgen einem ähnlichen Muster.

Für ein Unternehmen heißt das: Die Bolt-Telefonnummer ist praktisch der Kontoschlüssel. Teams, die ein Firmen-Reisekonto betreiben, prüfen, wie sich ihre eigene Partnerintegration in einer neuen Stadt verhält, oder die private SIM eines Mitarbeitenden aus einem gemeinsamen Arbeits-Login heraushalten wollen, brauchen alle eine kontrollierte Möglichkeit, diesen Code zu empfangen.

Checkliste vor der Bestellung einer Bolt-Nummer

Gehen Sie diese Punkte durch, bevor Sie etwas ausgeben:

• Der Zweck ist legitim: Das Konto gehört Ihrer Organisation oder ist ein Testkonto für Ihr eigenes Produkt, und die Bedingungen von Bolt erlauben es.
• Der Markt ist gewählt: Das Land der Nummer passt dazu, wo das Konto betrieben wird. Ein Fahrgastkonto, das mit der Nummer eines Landes registriert und woanders genutzt wird, kann sich anders verhalten.
• API-Schlüssel bereit: ein Bearer-Schlüssel mit dem Präfix or_live_, erstellt in der Developer-Konsole (bis zu 10 pro Konto).
• Webhook-Endpunkt getestet: für activation.sms_received abonniert, mit eingeschalteter Signaturprüfung.
• Wallet aufgeladen: prüfen Sie dies mit GET /api/v1/balance, oder fordern Sie den Sandbox-Modus an, um den Ablauf mit simulierten Nummern zu proben.
• Ausweichplan vereinbart: Legen Sie vorab fest, was der Test tut, wenn kein Code zurückkommt.

Welche Länder haben Bolt-Routen?

Bolt-Routen sind derzeit für 198 Länder gelistet. Beispiele sind Estland, Lettland, Litauen, Polen, die Tschechische Republik, Portugal, Deutschland, Kroatien, Malta, Georgien, Südafrika, Nigeria, Kenia, Ghana, Tansania und Uganda.

Wählen Sie das Land bewusst. Funktionen, Zahlungsoptionen und Registrierungsprüfungen von Bolt unterscheiden sich je nach Markt, ein Test in Warschau sagt daher wenig über einen Ablauf in Nairobi aus. Die Verfügbarkeit pro Land ändert sich im Tagesverlauf; GET /api/v1/prices und das Dashboard zeigen, was gerade live ist.

Schritt für Schritt: die Bolt-Verifizierungscode-API

1. Bestätigen Sie die Dienst-ID mit GET /api/v1/services; für Bolt lautet sie bolt.
2. Wählen Sie die Länder-ID aus GET /api/v1/countries, zum Beispiel ee für Estland.
3. Lesen Sie den aktuellen Preis: GET /api/v1/prices?country=ee&service=bolt.
4. Bestellen Sie: POST /api/v1/activations mit {"service": "bolt", "country": "ee"}. Speichern Sie die Aktivierungs-ID und die zurückgegebene Nummer.
5. Geben Sie die Nummer in der Bolt-App auf Ihrem Testgerät ein und fordern Sie die SMS an.
6. Verarbeiten Sie das Ereignis activation.sms_received. Prüfen Sie X-OTPRoute-Signature: t=<unix>,v1=<hex>, indem Sie HMAC-SHA256 über <t>.<raw body> mit dem Endpunkt-Secret berechnen, weisen Sie alte Zeitstempel ab und schreiben Sie anhand der Aktivierungs-ID, sodass eine wiederholte Zustellung nichts ändert.
7. Sind Webhooks keine Option, fragen Sie GET /api/v1/activations/{id} alle paar Sekunden per Polling ab, weit innerhalb des Limits von 300 Anfragen pro Minute.
8. Rufen Sie POST /api/v1/activations/{id}/cancel auf, wenn der Test abgebrochen wird.

Die Endpunktdetails stehen in der API-Dokumentation, und OTP-Webhooks absichern erklärt die Signaturprüfung.

Schritt für Schritt: der Weg über das Dashboard

Für eine einzelne Bolt-SMS-Verifizierung zum Testen oder eine einmalige Kontoeinrichtung genügt der Browser. Melden Sie sich an, öffnen Sie das OTP Gateway, wählen Sie Bolt und den Markt, prüfen Sie den Preis und bestätigen Sie. Kopieren Sie die Nummer in die App, fordern Sie den Code an und beobachten Sie, wie er auf der Bestellkarte erscheint, bevor der 20-Minuten-Timer abläuft.

Fehlersuche: Der Bolt-Code ist nie angekommen

Ein leeres Zeitfenster kostet nichts; vergehen 20 Minuten ohne SMS oder brechen Sie ab, geht der volle Betrag in Ihr Wallet zurück. Häufige Gründe und Lösungen:

• Bolt hat die Nummer abgelehnt: Wie viele Plattformen akzeptiert Bolt nicht in jedem Markt eine virtuelle Nummer für die Registrierung. Probieren Sie eine andere Länderroute, wenn Ihr Test es zulässt, oder einen späteren Versuch.
• Langsame Zustellung: Das Timing hängt vom Dienst und von der Route ab, lassen Sie das Zeitfenster also ablaufen, bevor Sie abbrechen.
• Wiederholte Anfragen: Mehrfaches Tippen auf „Erneut senden“ oder Neubestellen in einer Schleife kann die eigene Drosselung von Bolt auslösen. Lassen Sie Abstand zwischen den Versuchen.
• Falscher Markt: Eine Nummer aus einem Land, das Bolt in Ihrem Testszenario nicht bedient, wird womöglich nie akzeptiert.

Der Leitfaden zum Länder-Routing für OTP behandelt die Wahl von Ausweichrouten.

Wann passt eine Dedicated Number besser?

Eine Einmalnummer eignet sich für eine einzelne Verifizierung. Muss sich ein Bolt-Konto Wochen später erneut anmelden, etwa ein Staging-Fahrgastprofil, das Ihr QA-Team wiederverwendet, oder ein Betriebs-Login, der auf neuen Geräten erneut verifiziert wird, muss die Nummer bei Ihnen bleiben. Das leisten Dedicated Numbers, aber nur in den Vereinigten Staaten und in Kanada, ab $1.95/month, mit eingehenden SMS im Dashboard und an Ihren Webhook weitergeleitet als number.sms_received. Prüfen Sie, ob der Bolt-Markt des Kontos mit einer US-amerikanischen oder kanadischen Nummer funktioniert, bevor Sie sich darauf verlassen. Details finden Sie unter virtuelle Nummern.

Bolt-Nummern verantwortungsvoll nutzen

Beachten Sie die Nutzungsbedingungen von Bolt in jedem Markt. Bleiben Sie bei einem Konto pro realer Person oder Unternehmen und nutzen Sie OTP Route nur, um Ihre eigenen Produkte zu testen oder legitime Konten zu betreiben, die Ihrer Organisation gehören; Wegwerf-Fahrgastprofile anzulegen oder Aktionen einzusammeln ist keine zulässige Nutzung. Die Acceptable Use Policy von OTP Route gilt für jede Bestellung, und Bolt ist eine Marke ihres Inhabers, ohne dass eine Verbindung impliziert wird.

Häufige Fragen

Kann ich einen Bolt-OTP ohne lokale SIM-Karte empfangen?

Ja. Bestellen Sie eine Nummer für den Dienst bolt im richtigen Land, geben Sie sie in der App ein und lesen Sie den Code in Ihrem Dashboard oder über die API.

Wie lautet die Bolt-Dienst-ID in der API?

Sie lautet bolt. Kombinieren Sie sie mit einer Länder-ID wie pl oder ke, wenn Sie POST /api/v1/activations aufrufen.

Was kostet eine Bolt-Verifizierungsnummer?

Ab $0.20 pro Code. Der genaue Betrag hängt vom Land ab und kommt live von GET /api/v1/prices.

Akzeptiert Bolt jede virtuelle Nummer?

Nein. Bolt kann virtuelle Nummern in manchen Märkten oder Abläufen ablehnen; deshalb wird ein nicht zugestellter Code automatisch erstattet.

Welches Land sollte ich für einen Bolt-Test wählen?

Nutzen Sie das Land, in dem das Konto tatsächlich verwendet wird, damit Registrierungsregeln, Sprache und Zahlungsoptionen dem entsprechen, was echte Nutzer sehen.

Kann ich dieselbe Nummer für künftige Bolt-Anmeldungen behalten?

Nicht mit einer einmaligen Aktivierung. Für wiederholte Anmeldungen ist eine Dedicated Number in den USA oder in Kanada die selbst buchbare Option.

Kann ich den Ablauf testen, bevor ich zahle?

Ja. Fordern Sie den Sandbox-Modus für ein Entwicklungskonto an, um simulierte Nummern und Codes zu erhalten, ohne Wallet-Guthaben auszugeben.

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.