Checkliste für den Empfang von +375-Verifizierungscodes aus Belarus

Was sollte bereitstehen, bevor Sie eine +375-Nummer anfordern?

Haken Sie diese Punkte ab, bevor Sie eine +375-Nummer zum Testen verwenden:

• Ein Konto und ein aufgeladenes Wallet. Erstellen Sie eines unter /signup mit E-Mail und 6-stelligem E-Mail-Code oder per Google-Anmeldung und laden Sie dann ein kleines Guthaben auf. Aktivieren Sie die TOTP-Zwei-Faktor-Authentifizierung für das Konto, das die API-Schlüssel hält.
• Ein Bearer-Schlüssel mit dem Präfix or_live_, erstellt in der Developer-Konsole. Geben Sie CI und lokaler Entwicklung getrennte Schlüssel; ein Konto kann bis zu 10 halten.
• Die beiden IDs, die Sie senden. Belarus ist in der API by, und die Dienst-ID ist der von GET /api/v1/services gelieferte Wert api_service.
• Ein Empfangs-Endpoint, falls Sie Webhooks nutzen wollen, mit seinem Signatur-Secret außerhalb des Repositorys.
• Ein Testkonto in Ihrem eigenen Produkt, bei dem eine Telefonnummer geändert oder hinzugefügt werden darf.
• Eine auf die Region BY konfigurierte Telefonbibliothek, damit die Nummer, die Sie in Ihr Registrierungsformular einfügen, so geparst wird, wie ein echter belarussischer Nutzer sie eintippen würde.

Wie werden belarussische Nummern geschrieben, und wie sollte Ihre App sie speichern?

Belarus verwendet die Landesvorwahl +375 gefolgt von einer neunstelligen nationalen Nummer. Mobilnummern beginnen mit Betreibervorwahlen wie 25, 29, 33 oder 44, sodass ein gespeicherter Wert so aussieht: +37529XXXXXXX.

Der knifflige Teil ist die inländische Gewohnheit. Im Land schreibt man eine Mobilnummer oft mit führendem 80, etwa 8 029 XXX-XX-XX, was vom Fernwahlpräfix stammt. Dieses 80 muss entfernt werden, bevor die Landesvorwahl ergänzt wird; ein Formular, das es behält, erzeugt einen ungültigen E.164-String, den manche Verifizierungsdienste stillschweigend ablehnen. Gute Normalisierungstests für eine Belarus-Verifizierungsnummer:

• +375 29 ..., 375 29 ... und 8 029 ... akzeptieren und alle drei identisch speichern;
• die Nummer in einer lokal gewohnten Gruppierung anzeigen, aber nur E.164 an Ihre SMS- oder Verifizierungsschicht senden;
• eine Nummer ablehnen, die nach der 375 noch ein 80 enthält.

Belarussisch und Russisch sind beide Amtssprachen, wobei im Alltag überwiegend Russisch gesprochen wird. Viele Dienste senden ihren Codetext je nach Kontosprache auf Russisch oder Englisch; prüfen Sie daher, dass Ihre App kyrillische Schrift auf jedem Bildschirm korrekt darstellt, der die Nachricht wiedergibt.

Für welche Dienste kann eine Belarus-Verifizierungsnummer Codes empfangen?

Das OTP-Routing für Belarus bei OTP Route deckt aktuell mehr als 1.400 Dienste unter der ID by ab. Zu den beliebten Routen im aktuellen Snapshot gehören Telegram, Viber, WhatsApp, Signal, Google (Gmail & YouTube), Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Amazon und AliExpress.

Die Verfügbarkeit einer einzelnen Route ändert sich im Tagesverlauf; betrachten Sie eine solche Liste daher als Ausgangspunkt, nicht als Zusage. Fragen Sie vor einem Lauf mit GET /api/v1/prices?country=by&service=<id> den aktuellen Preis ab und ob die Route gerade eine Bestellung annehmen kann. Wie Sie zwischen Ländern wählen, beschreibt Länder-Routing für OTP.

Schritt für Schritt: der Belarus-OTP-API-Ablauf aus einem Testskript

Jede Anfrage geht mit Ihrem Bearer-Schlüssel an https://otproute.com/api/v1. Die SMS-Verifizierungs-API ist klein genug, um sie in einen einzigen Helfer zu packen:

1. Rufen Sie GET /api/v1/balance auf und beenden Sie den Job früh, wenn das Wallet für die Suite zu niedrig ist.
2. Rufen Sie GET /api/v1/prices?country=by&service=telegram auf (setzen Sie Ihre Dienst-ID ein) und protokollieren Sie den Preis, den Sie gleich zahlen werden.
3. Legen Sie die Bestellung mit POST /api/v1/activations und einem Body wie {"service": "telegram", "country": "by"} an. Speichern Sie die Aktivierungs-ID und die +375-Nummer aus der Antwort.
4. Übergeben Sie diese Nummer an den Telefonschritt Ihrer eigenen App und lösen Sie den Code aus.
5. Holen Sie den Code aus einem activation.sms_received-Ereignis oder per Polling von GET /api/v1/activations/{id}. Das Limit liegt bei 300 Anfragen pro Minute.
6. Bricht der Test ab, rufen Sie POST /api/v1/activations/{id}/cancel auf, damit der reservierte Betrag sofort ins Wallet zurückgeht.

Lesen Sie bei Webhooks den Header X-OTPRoute-Signature (t=<unix>,v1=<hex>), berechnen Sie HMAC-SHA256 über <t>.<raw body> mit dem Endpoint-Secret, vergleichen Sie konstantzeitlich und verwerfen Sie Zustellungen mit veraltetem Zeitstempel. Verarbeiten Sie Ereignisse anhand der Aktivierungs-ID, damit eine wiederholte Zustellung harmlos bleibt. Die API-Dokumentation und der Leitfaden zum Absichern von OTP-Webhooks mit HMAC behandeln die Details.

Schritt für Schritt: dieselbe Aufgabe im Dashboard

Support-Mitarbeitende, die nur gelegentlich einen Code brauchen, können die API überspringen:

1. Öffnen Sie im Dashboard das OTP Gateway und wählen Sie Belarus.
2. Wählen Sie den Dienst; der Preis für diese Route erscheint vor der Bestätigung.
3. Kopieren Sie die +375-Nummer und geben Sie sie in der App ein, die Sie testen.
4. Beobachten Sie die Bestellkarte. Der Code erscheint dort, sobald er eintrifft.

Kommt innerhalb von 20 Minuten nichts an, wird die Bestellung geschlossen und der volle Betrag gutgeschrieben. Sie zahlen nur, wenn ein Code zugestellt wird.

Fehlersuche: Der +375-Code ist nicht angekommen

Übliche Ursachen und der jeweils nächste Schritt:

• Der Dienst hat die Nummer abgelehnt. Manche Plattformen weisen virtuelle Nummern zurück. Genau für diesen Fall gibt es die Erstattungsregel; probieren Sie eine andere Dienstroute oder ein anderes Land, falls der Test das zulässt.
• Die Nummer wurde in inländischer Form eingegeben. Prüfen Sie erneut, dass Ihr Formular +375 plus neun Ziffern übermittelt hat, ohne das 80.
• Die Route ist ausgelastet. Lassen Sie das Fenster ablaufen, statt nach einer Minute abzubrechen, und versuchen Sie es später erneut.
• Ihr Skript bestellt in enger Schleife neu. Bauen Sie zwischen den Versuchen ein Back-off ein; schnelle Wiederholungsbestellungen beim selben Dienst helfen selten und können auf der Zielplattform missbräuchlich wirken.

Weitere Fehlermuster bei +375-Bestellungen behandelt weniger fehlgeschlagene OTP-Zustellungen.

Gibt es eine belarussische Langzeitnummer, und wie funktioniert die Abrechnung?

Nein. OTP Route bietet für Belarus keine selbst buchbare Langzeitnummer. Braucht Ihr Team eine für einen Betriebs- oder Support-Anwendungsfall, schreiben Sie an [email protected] und beschreiben Sie ihn; ob sich etwas anbieten lässt, hängt von den lokalen Vorschriften ab, und es wird nichts zugesagt. Dedicated Virtual Numbers sind ein Produkt für die USA und Kanada, ab $1.95/Monat, mit eingehenden SMS, ausgehenden SMS und Telefonieren im Browser.

Belarussische Bestellungen laufen über dasselbe vorausbezahlte USD-Wallet wie jede andere Route, ohne monatliche Gebühr und ohne Tarifstufe. Laden Sie per Karte oder mit USDT/USDC-Stablecoins auf; zu jeder Aufladung landet eine PDF-Rechnung in Ihrem Postfach. Entwickler können ein Sandbox-Konto anfragen, das simulierte Nummern und Codes liefert – der günstigste Weg, eine Integration vor echten Bestellungen zu belegen. Verwenden Sie jede Nummer nur für Ihr eigenes Produkt oder Ihre eigenen legitimen Konten, beachten Sie die Bedingungen des jeweiligen Dienstes und denken Sie daran, dass die Acceptable Use Policy von OTP Route gilt. Aktuelle Werte stehen unter Preise.

Häufige Fragen

Kann ich den Registrierungsablauf meiner App für Belarus ohne lokale SIM testen?

Ja. Bestellen Sie im OTP Gateway eine +375-Nummer für Ihren Dienst, übermitteln Sie sie in Ihrem Registrierungsformular und lesen Sie den Code im Dashboard oder über die API ab.

Wie lautet die Länder-ID für Belarus in der OTP-Route-API?

Sie lautet by. Verwenden Sie sie in GET /api/v1/prices und im Body von POST /api/v1/activations.

Soll ich belarussische Nummern mit dem Präfix 80 speichern?

Nein. Speichern Sie sie in E.164 als +375 gefolgt von neun Ziffern und lassen Sie das inländische 80 weg, sonst behandeln viele Dienste die Nummer als ungültig.

Was passiert mit meinem Geld, wenn die +375-Nummer nie einen Code erhält?

Endet das 20-Minuten-Fenster ohne SMS oder brechen Sie ab, geht der volle Betrag automatisch zurück in Ihr Wallet.

In welcher Sprache kommt die Verifizierungs-SMS an?

Das entscheidet der sendende Dienst. Bei belarussischen Nummern ist es häufig Russisch oder Englisch, abhängig von der Konto- oder Gerätesprache.

Kann ich eine +375-Nummer für künftige Logins behalten?

Nicht per Selbstbedienung. Dedizierte Langzeitnummern gibt es nur für die USA und Kanada; für Belarus können Sie an [email protected] schreiben und nachfragen, ohne Zusage der Verfügbarkeit.

Gibt es einen Weg, die Integration zu testen, ohne Wallet-Guthaben auszugeben?

Ja. Ein Entwicklungskonto lässt sich auf Anfrage auf Sandbox umstellen und liefert simulierte Nummern und Codes für Ende-zu-Ende-Tests.

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.