Ungarische (+36) Telefonverifizierung testen: Checkliste, Schritte und Lösungen

Checkliste: Ist Ihr Stack bereit für einen Ungarn-OTP-API-Lauf?

Gehen Sie diese Liste einmal pro Projekt durch, nicht einmal pro Test:

1. Kontosicherheit. Registrieren Sie sich unter /signup und aktivieren Sie TOTP-Zwei-Faktor-Authentifizierung, bevor Sie Schlüssel erzeugen.
2. Schlüssel pro Umgebung. Erstellen Sie or_live_-Schlüssel in der Developer-Konsole, einen je Pipeline oder Entwicklerrechner, damit ein durchgesickerter Schlüssel widerrufen werden kann, ohne alle anderen zu stoppen.
3. IDs in der Konfiguration, nicht im Code. Ungarn ist hu; lesen Sie Dienst-IDs aus GET /api/v1/services und halten Sie die Zuordnung in einer Konfigurationsdatei.
4. Webhook-Ziel. Registrieren Sie einen HTTPS-Endpunkt (bis zu 5 pro Konto) und legen Sie sein Secret in Ihrem Secrets-Manager ab.
5. Budgetschutz. Lassen Sie die Suite zuerst GET /api/v1/balance aufrufen und sauber beenden, wenn das Guthaben knapp ist.
6. Regionsbewusstes Parsen. Stellen Sie sicher, dass Ihr Telefonfeld die Region HU kennt, denn Ungarn tippen in einem Inlandsformular selten die Landesvorwahl.

Die Lösungsseite zu QA-Tests zeigt, wie Teams das üblicherweise in einem Test-Framework aufbauen.

Warum verdient die Behandlung von +36-Nummern eigene Testfälle?

Die Landesvorwahl Ungarns ist +36, und das nationale Ortsnetz-Präfix ist 06. Ein ungarischer Nutzer gibt eine Mobilnummer oft als 06 30 123 4567 oder 06 20 ... ein, wobei 20, 30, 31, 50 und 70 gängige Mobilfunk-Präfixe sind. Ihr Formular muss das in +3630... umwandeln, indem es die 06 entfernt und sie keinesfalls hinter der Landesvorwahl stehen lässt. Schreiben Sie ausdrückliche Testfälle für:

• 06 30 ... in einem Feld im nationalen Format;
• +36 30 ... und 0036 30 ..., da 00 das internationale Zugangspräfix ist;
• Leerzeichen, Schrägstriche und Bindestriche, die in realen Eingaben in jeder Kombination vorkommen.

Ungarisch ist Amtssprache, und viele Dienste senden ihren Code auf Ungarisch, sobald die Kontosprache darauf gestellt ist. Die Buchstaben ő und ű gehören nicht zum 7-Bit-GSM-Alphabet, sodass eine ungarische Nachricht, die sie enthält, als UCS-2 kodiert wird und jedes Segment weniger Zeichen fasst. Das ist wichtig, wenn Ihr eigenes Produkt ungarische Codes sendet, und ein guter Grund, in Ihren Testprotokollen den empfangenen Text zu lesen und nicht nur die extrahierten Ziffern. Ungarische Wörter sind zudem lang, daher sollte die Lokalisierungs-QA prüfen, dass der Telefonschritt und seine Fehlermeldungen auch auf kleinen Bildschirmen noch passen.

Welche ungarischen Routen stehen für eine +36-Nummer zum Testen bereit?

Das OTP-Routing für hu umfasst derzeit mehr als 1.600 Dienste. Häufig angefragte Routen im aktuellen Snapshot sind WhatsApp, Viber, Facebook, Instagram, Google (Gmail & YouTube), Uber, Airbnb, eBay, Amazon, LinkedIn, Netflix und ChatGPT (OpenAI).

Diese Routen sind eine Momentaufnahme; der Bestand bewegt sich im Tagesverlauf, weshalb die API bei jeder Preisabfrage die Verfügbarkeit mitliefert. Fragen Sie GET /api/v1/prices?country=hu&service=<id> unmittelbar vor der Bestellung ab, statt eine alte Antwort zwischenzuspeichern.

Schritte: Ungarn-SMS-OTP-Codes über die API empfangen

Ist die Checkliste abgearbeitet, braucht ein einzelner Test über die SMS-Verifizierungs-API höchstens fünf Aufrufe, alle gegen https://otproute.com/api/v1:

1. GET /api/v1/prices?country=hu&service=uber, um die Route zu bestätigen und den Preis festzuhalten.
2. POST /api/v1/activations mit {"service": "uber", "country": "hu"}. Behalten Sie die Aktivierungs-ID; sie ist der Schlüssel für alles Weitere.
3. Übergeben Sie die zurückgegebene +36-Nummer an den Verifizierungsbildschirm Ihrer App.
4. Empfangen Sie den Code. Ein Webhook liefert activation.sms_received; beim Polling wird GET /api/v1/activations/{id} genutzt. Wählen Sie pro Job einen Weg, damit beide Pfade nicht konkurrieren.
5. Bei einem Testfehler POST /api/v1/activations/{id}/cancel, um das Guthaben sofort freizugeben.

Prüfen Sie jeden Webhook, bevor Sie ihm vertrauen: Teilen Sie X-OTPRoute-Signature in t und v1, berechnen Sie HMAC-SHA256 über <t>.<raw body> mit dem Endpoint-Secret, vergleichen Sie in konstanter Zeit und weisen Sie zu alte Zeitstempel zurück. Behandeln Sie activation.expired und activation.cancelled als Endzustände, damit Wiederholungen aufhören. Ein durchgespieltes Beispiel steht im OTP-API-Integrationsleitfaden.

Schritte für Kollegen, die die API nie anfassen

Mitarbeiter aus Customer Success oder Marketing können das Dashboard nutzen. Öffnen Sie das OTP Gateway, wählen Sie Ungarn und den Dienst, prüfen Sie den angezeigten Preis, bestätigen Sie und fügen Sie die +36-Nummer in die App ein. Der Code erscheint direkt an der Bestellung. Kommt innerhalb von 20 Minuten nichts an, läuft die Bestellung ab und das Guthaben wird vollständig gutgeschrieben, ein gescheiterter Versuch kostet also nichts.

Fehlersuche bei einer ungarischen Verifizierungsnummer, die stumm bleibt

Gehen Sie diese Punkte durch, bevor Sie ein Ticket öffnen:

• Wurde die Nummer als E.164 übermittelt? Eine überflüssige 06 hinter +36 ist der häufigste selbst verursachte Fehler.
• Akzeptiert der Dienst virtuelle Nummern? Manche nicht. Die automatische Erstattung deckt das ab, und der Wechsel auf eine andere Dienstroute oder ein Nachbarland ist meist der schnellste Weg weiter.
• Haben Sie das Fenster abgewartet? Ein Abbruch nach kurzem Warten kann einen Code verwerfen, der schon unterwegs war. Lassen Sie die Bestellung laufen und versuchen Sie es später erneut.
• Bearbeitet das Skript eine einzelne Route mit Dauerfeuer? Staffeln Sie Wiederholungen mit einem Backoff. Wiederholte Sofortbestellungen helfen selten und können die eigenen Missbrauchsprüfungen einer Plattform auslösen.

Der Artikel zum Reduzieren fehlgeschlagener OTP-Zustellungen geht weiter ins Detail.

Langzeitnummern, Guthaben und verantwortungsvolle Nutzung in Ungarn

Für Ungarn gibt es keine langfristige Self-Service-Nummer. Braucht ein Betriebs- oder Support-Team eine, schreiben Sie mit dem Anwendungsfall an [email protected]; die Verfügbarkeit hängt von den lokalen Vorschriften ab und kann nicht zugesagt werden. Dedizierte virtuelle Nummern im Self-Service gibt es nur für US-amerikanische und kanadische Leitungen, ab $1.95/Monat.

OTP Route rechnet über ein einziges prepaid USD-Guthaben ab: keine Monatsgebühr, kein Tarif, Aufladung per Karte oder USDT/USDC und eine PDF-Rechnung per E-Mail für jede Aufladung. Ein Sandbox-Modus mit simulierten Nummern und Codes kann für Integrationstests auf Anfrage aktiviert werden. Nutzen Sie Nummern nur, um Ihre eigenen Produkte und legitimen Konten zu testen oder zu betreiben, beachten Sie die Bedingungen der Dienste und denken Sie daran, dass die Richtlinie zur akzeptablen Nutzung von OTP Route gilt.

Häufige Fragen

Kann mein QA-Team einen ungarischen SMS-Code ohne ungarische SIM-Karte empfangen?

Ja. Bestellen Sie über das OTP Gateway eine +36-Nummer für den jeweiligen Dienst und holen Sie den Code im Dashboard oder über die API ab.

Welche Länder-ID verwendet die API für Ungarn?

Verwenden Sie hu, zum Beispiel in POST /api/v1/activations mit einem Body wie {"service": "uber", "country": "hu"}.

Wie wandle ich eine als 06 30 123 4567 geschriebene Nummer um?

Entfernen Sie das Ortsnetz-Präfix 06 und ergänzen Sie +36, sodass +36301234567 entsteht. Speichern Sie diese E.164-Form und formatieren Sie sie nur für die Anzeige.

Zahle ich, wenn eine ungarische Route keinen Code zustellt?

Nein. Kommt innerhalb von 20 Minuten keine SMS an oder brechen Sie ab, wird der volle Betrag automatisch auf Ihr Guthaben zurückgebucht.

Warum sieht eine ungarische Code-Nachricht manchmal anders aus als eine englische?

Ungarische Texte können ő oder ű enthalten, was die Nachricht in die UCS-2-Kodierung zwingt. Die Ziffern bleiben gleich; nur Nachrichtentext und Länge ändern sich.

Kann ich eine ungarische Nummer kaufen, die ich monatelang behalte?

Nicht als Self-Service-Produkt. Dedizierte Nummern gibt es nur in den USA und Kanada; für Ungarn können Sie per E-Mail an [email protected] anfragen, ohne Zusage, dass sich etwas einrichten lässt.

Wie viele Dienste unterstützt OTP Route für Ungarn?

Zum Zeitpunkt der Erstellung mehr als 1.600. Rufen Sie GET /api/v1/countries auf oder sehen Sie im Dashboard die aktuelle Liste ein.

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.