Mit Ziel Japan ohne japanisches Handy: +81-Codes testen

Warum gerät ein Japan-Launch beim Schritt mit der Telefonnummer ins Stocken?

Teams, die eine japanische Version vorbereiten, haben meist die Übersetzung fertig, die Zahlungsmethoden angebunden und den App-Store-Eintrag entworfen. Dann fragt jemand, wer den Registrierungsablauf mit einer echten +81-Nummer verifizieren soll, und der Raum wird still.

Die Lücke zeigt sich an ein paar vorhersehbaren Stellen:

• Die Lokalisierungs-QA muss bestätigen, dass das Telefonfeld die Formate akzeptiert, die japanische Nutzer tatsächlich eintippen, auch Nummern mit Bindestrichen.
• Regionale Betriebsteams in Tokio oder Osaka müssen nach einem Gerätewechsel ein gemeinsames Geschäftskonto wiederherstellen, und niemand möchte dafür eine private Nummer hinterlegen.
• Partner und Integrationen mit japanischen Plattformen verlangen beim Onboarding eines Geschäftsprofils manchmal eine lokale Nummer.

Das OTP Gateway beseitigt die Abhängigkeit von einer physischen SIM-Karte. Es gibt Ihnen eine +81-Nummer für eine Verifizierung, sammelt die SMS über das OTP-Routing unserer Carrier-Partner und übergibt das Ergebnis an Ihren Code oder Ihren Browser.

Was kann ich mit einer +81-Nummer zum Testen verifizieren?

Eine japanische Verifizierungsnummer lässt sich derzeit für mehr als 1.500 Dienste bestellen. Beliebte Routen im aktuellen Stand sind LINE, X (Twitter), Amazon, Netflix, Google (Gmail & YouTube), Instagram, TikTok, Discord, Uber, Airbnb, Microsoft & Outlook, ChatGPT (OpenAI), Facebook und WhatsApp.

LINE verdient einen besonderen Hinweis, weil es für einen großen Teil der Menschen in Japan die Standard-Messaging-App ist. Ein Produkt mit LINE-Login oder LINE-Benachrichtigungen sollte diesen Pfad deshalb ebenso abdecken wie reine SMS. Die Verfügbarkeit ändert sich im Tagesverlauf, weshalb die Liste in Ihrem Tooling aus der API stammen sollte und nicht von dieser Seite.

Wie binde ich die Japan-OTP-API in einen Test-Runner ein?

Die SMS-Verifizierungs-API liegt unter https://otproute.com/api/v1. Erstellen Sie in der Developer-Konsole einen Schlüssel (er beginnt mit or_live_), senden Sie ihn als Bearer-Token und bleiben Sie unter 300 Anfragen pro Minute. Ein Konto kann 10 Schlüssel und 5 Webhook-Endpunkte halten.

Ein typischer Durchlauf sieht so aus:

1. Lösen Sie die IDs einmal mit GET /api/v1/services und GET /api/v1/countries auf; Japan ist jp.
2. Rufen Sie den aktuellen Preis über GET /api/v1/prices?country=jp&service=<id> ab und speichern Sie ihn mit dem Testergebnis.
3. Legen Sie die Bestellung mit POST /api/v1/activations und dem Body {"service": "<id>", "country": "jp"} an.
4. Tippen Sie die zurückgegebene Nummer in die getestete App ein und lösen Sie die SMS aus.
5. Empfangen Sie activation.sms_received an Ihrem Webhook oder fragen Sie GET /api/v1/activations/{id} per Polling ab, wenn der Runner hinter einer Firewall sitzt.
6. Rufen Sie beim Teardown POST /api/v1/activations/{id}/cancel für jede Aktivierung auf, die der Test nicht mehr braucht.

Webhook-Requests tragen X-OTPRoute-Signature: t=<unix>,v1=<hex>. Berechnen Sie HMAC-SHA256 über <t>.<raw body> mit dem Endpoint-Secret neu, vergleichen Sie sicher und lehnen Sie alte Zeitstempel ab. Behandeln Sie Events über die Aktivierungs-ID, damit eine Wiederholung unschädlich ist. Zu CI-Details siehe SMS-OTP-Tests in CI-Pipelines und die QA-Test-Lösung.

Kann ein Nicht-Entwickler im Büro in Tokio das im Browser erledigen?

Ja. Öffnen Sie im OTP Route Dashboard das OTP Gateway, wählen Sie Japan und den Dienst, prüfen Sie den angezeigten Preis und bestätigen Sie. Die Nummer wird sofort angezeigt; sobald die Nachricht eintrifft, erscheint der Code daneben. Es muss nichts installiert werden, was den Weg für eine Support-Leitung oder einen Marketing-Manager praktisch macht, die den Ablauf einer Kampagnen-Landingpage prüfen.

Wie sind japanische Mobilnummern formatiert, und wie sehen die Nachrichten aus?

Japan verwendet im Inland die Vorwahl 0. Mobilnummern werden meist als 070, 080 oder 090 gefolgt von acht Ziffern geschrieben, oft mit Bindestrichen gruppiert. In E.164 entfällt die Null, aus 090 und dem Rest wird +81 90 plus acht Ziffern. Speichern Sie nur die E.164-Version, entfernen Sie Bindestriche und Leerzeichen, die Nutzer eintippen, und stellen Sie sicher, dass Ihr Validator den Bereich 070 nicht ablehnt.

Verifizierungsnachrichten kommen oft auf Japanisch an, mit einer Mischung aus Kanji, Hiragana und Katakana, und manche enthalten vollbreite Ziffern statt gewöhnlicher ASCII-Zahlen. Führen Sie den Text vor dem Extrahieren des Codes durch eine Unicode-NFKC-Normalisierung, sonst kann ein regulärer Ausdruck für [0-9] ihn unbemerkt verfehlen. Japanischer Text bedeutet außerdem, dass die SMS in einer Unicode-Kodierung gesendet wird; halten Sie Ihre Logs deshalb in UTF-8, um Fehler später lesen zu können.

Der Code ist nicht angekommen. Was sollten wir versuchen?

Keine Ankunft bedeutet keine Kosten: Vergehen 20 Minuten ohne SMS oder brechen Sie ab, wird der volle Betrag automatisch dem Guthaben gutgeschrieben. Bevor Sie erneut bestellen:

• Geben Sie dem Fenster Zeit; ein verspäteter Code wird trotzdem erfasst.
• Versuchen Sie es nach einer Pause erneut oder wechseln Sie auf eine andere Route für denselben Dienst.
• Prüfen Sie, ob der Dienst überhaupt virtuelle Nummern akzeptiert, denn manche lehnen sie ab.
• Vermeiden Sie in der Automatisierung schnelle Neubestellungen in einer Schleife; verteilen Sie die Versuche zeitlich.

Der Artikel zum Länder-Routing für OTP erklärt, warum sich Routen unterscheiden.

Gibt es eine langfristige japanische Nummer, und wie wird das Guthaben abgerechnet?

OTP Route bietet keine langfristige japanische Nummer im Self-Service an. Dedicated Virtual Numbers sind ein Produkt für die USA und Kanada ab $1.95/Monat; ist eine langfristige +81-Leitung unverzichtbar, schreiben Sie an [email protected], und das Team prüft, was die lokalen Vorschriften erlauben, ohne Zusage, dass es möglich ist.

Bezahlt wird über ein einziges vorausbezahltes USD-Guthaben: kein Abo und kein Tarif. Laden Sie per Karte oder mit USDT/USDC auf, und für jede Aufladung kommt eine PDF-Rechnung per E-Mail. Auf Anfrage kann ein Entwicklungskonto im Sandbox-Modus mit simulierten Nummern und Codes laufen. Aktuelle Werte finden Sie auf der Preisseite.

Häufige Fragen

Kann ich Japan-SMS-OTP-Codes ohne japanische SIM-Karte empfangen?

Ja. Das OTP Gateway stellt eine +81-Nummer für eine Verifizierung aus und zeigt den Code im Dashboard an oder sendet ihn an Ihren Webhook.

Welche Länder-ID sende ich in API-Aufrufen für Japan?

Verwenden Sie jp im Aktivierungs-Body und in der Preisabfrage.

Warum übersieht mein Parser Codes in japanischen Nachrichten?

Die Nachricht kann vollbreite Ziffern enthalten. Wenden Sie vor dem Abgleich die NFKC-Normalisierung an, dann passt der Code auf ein gewöhnliches Ziffernmuster.

Sollten 090-Nummern mit führender Null gespeichert werden?

Nein. Speichern Sie +81 gefolgt von der Nummer ohne die Vorwahl-Null, zum Beispiel +81 90 und die restlichen acht Ziffern.

Was passiert mit meinem Geld, wenn kein japanischer Verifizierungscode ankommt?

Es geht automatisch auf Ihr Guthaben zurück, sobald das 20-Minuten-Fenster endet oder Sie die Aktivierung abbrechen.

Können wir LINE-Registrierungen für den japanischen Markt testen?

LINE gehört zu den für Japan verfügbaren Diensten, die Verfügbarkeit ändert sich jedoch. Prüfen Sie die Live-Liste und halten Sie sich bei jedem erstellten Konto an die Bedingungen von LINE.

Gibt es eine Regel, wie die Nummern verwendet werden dürfen?

Ja. Nutzen Sie sie nur für Ihre eigenen Produkte und legitimen Konten, beachten Sie die Bedingungen jedes Dienstes und bedenken Sie, dass die Acceptable Use Policy von OTP Route gilt.

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.