Eine Pre-Flight-Checkliste für den Empfang von +372-Verifizierungscodes in Estland

Was gehört auf die Checkliste vor der ersten +372-Bestellung?

Die meisten fehlgeschlagenen Testläufe gehen auf etwas zurück, das schon vor der Nummernanforderung gefehlt hat. Haken Sie zuerst Folgendes ab:

• Ein API-Key, erstellt in der Developer-Konsole. Jeder Key trägt das Präfix or_live_ und wird als Bearer-Token übermittelt; bei 10 möglichen Keys pro Konto verdient der CI-Runner einen eigenen.
• Ein Webhook-Endpoint mit serverseitig gespeichertem Secret, wenn Sie lieber aufgerufen werden als abzufragen. Fünf Endpoints pro Konto sind erlaubt.
• Die richtigen IDs. Estland ist in jeder Anfrage ee, und die Dienst-ID stammt aus GET /api/v1/services.
• Eine Live-Preisprüfung. Rufen Sie GET /api/v1/prices?country=ee&service=<id> auf, damit der Job die Kosten kennt, bevor er Wallet-Guthaben bindet.
• Sandbox, falls Sie noch an der Anbindung arbeiten. Auf Anfrage kann ein Entwicklungskonto in den Sandbox-Modus wechseln, der simulierte Nummern und Codes durchgängig liefert, ohne Ihr Guthaben zu berühren.
• Ein Anfragebudget. Die API akzeptiert 300 Anfragen pro Minute und Konto, was reichlich ist, solange keine Testsuite unbedacht abfragt.

Der Leitfaden zur OTP-API-Integration behandelt jeden dieser Punkte ausführlicher.

Wie führe ich eine Estland-OTP-API-Anfrage von Anfang bis Ende durch?

Ist die Checkliste erledigt, ist die Aufrufabfolge kurz:

1. POST /api/v1/activations mit dem Body {"service": "<id>", "country": "ee"}. Die Antwort enthält eine Aktivierungs-ID und die +372-Nummer, die Sie in das zu testende Registrierungs- oder Login-Formular eintragen.
2. Lösen Sie die Verifizierungs-SMS in der getesteten App aus.
3. Warten Sie auf den Code. Entweder erhält Ihr Endpoint activation.sms_received, oder Sie rufen GET /api/v1/activations/{id} in sinnvollen Abständen ab.
4. Geben Sie den Code in der App ein und halten Sie das Ergebnis zur Aktivierungs-ID fest.
5. Ändert sich der Testpfad und die Nummer wird nicht mehr gebraucht, rufen Sie POST /api/v1/activations/{id}/cancel auf, damit die Reservierung sofort freigegeben wird.

Lesen Sie bei Webhook-Zustellungen den Header X-OTPRoute-Signature (t=<unix>,v1=<hex>), berechnen Sie HMAC-SHA256 über <t>.<raw body> mit dem Endpoint-Secret, vergleichen Sie in konstanter Zeit und verwerfen Sie alles mit altem Zeitstempel. OTP-Webhooks mit HMAC absichern zeigt einen Referenz-Handler. Machen Sie Schreibvorgänge idempotent über die Aktivierungs-ID, denn ein Wiederholungsversuch kann dasselbe Ereignis zweimal zustellen.

Welche Dienste können Codes an eine estnische Verifizierungsnummer senden?

Der Live-Stand für Estland listet mehr als 1.700 Dienste. Beliebte Routen sind WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, LinkedIn, Microsoft & Outlook, Amazon, Discord, Signal, Uber, Airbnb und ChatGPT (OpenAI).

Der Bestand verändert sich im Tagesverlauf, eine Route, die heute Morgen geantwortet hat, kann abends dünn sein. Betrachten Sie GET /api/v1/countries und den Preis-Endpoint als maßgebliche Quelle, statt eine Liste fest in Ihre Test-Fixtures zu schreiben.

Wie sollten +372-Nummern gespeichert und validiert werden?

Estland hat einen der einfacheren Nummernpläne, und gerade deshalb scheitern nachlässige Validatoren daran. Es gibt keine Verkehrsausscheidungsziffer zu entfernen: Eine national geschriebene Nummer besteht aus denselben Ziffern, die Sie nach +372 anhängen. Mobilnummern beginnen meist mit 5 und sind sieben oder acht Ziffern lang, ein Regex mit fester nationaler Länge lehnt daher gültige Eingaben ab.

Praktische Regeln für Formulare und Datenbank:

• Speichern Sie den vollständigen E.164-String, etwa +3725xxxxxxx, und halten Sie die Roheingabe der Nutzer bei Bedarf für den Support getrennt vor.
• Stellen Sie nie eine Null voran; es gibt nichts zu entfernen oder hinzuzufügen.
• Testen Sie in Ihren Eingabemasken sowohl sieben- als auch achtstellige Mobilnummern.

Verifizierungstexte für estnische Nutzer kommen typischerweise auf Estnisch, doch viele Apps folgen der Konto- oder Gerätesprache, und auch russische oder englische Vorlagen sind üblich. Liefert Ihr Produkt eine estnische Lokalisierung aus, prüfen Sie, ob Buchstaben wie õ, ä, ö und ü den Weg von der Vorlage bis zum Handy unversehrt überstehen.

Warum testen Teams Registrierungsabläufe mit estnischen Nummern?

Estland spielt für Softwareteams über seiner Größe. Der Ruf als digitaler Staat und das e-Residency-Programm führen dazu, dass viele Gründer und Remote-Unternehmen eine Verbindung zum Land haben, selbst wenn das Team anderswo lebt, und Produkte für den baltischen und nordischen Raum starten oft zuerst dort.

Typische Gründe, warum eine QA-Leitung eine +372-Nummer für Tests anfordert:

• Bestätigen, dass Länderauswahl, Telefonmasken und SMS-Vorlagen in einem EU-Markt mit kurzem Nummernplan funktionieren.
• Lokalisierungsprüfungen für estnische Texte vor einem regionalen Release.
• Ein Support-Ticket eines estnischen Kunden nachstellen, dessen Code nie ankam.

Unter QA-Tests sehen Sie, wie Teams solche Prüfungen in ihren Release-Zyklus einbauen.

Was sollte ich prüfen, wenn der Code nicht erscheint?

Gehen Sie das Problem der Reihe nach durch, statt Nummer um Nummer zu bestellen:

1. Das Fenster ausreizen. Die Aktivierung bleibt 20 Minuten offen, und manche Dienste stellen ihre Texte in eine Warteschlange.
2. Prüfen, ob der Dienst virtuelle Nummern annimmt. Manche Dienste lehnen sie per Richtlinie ab; dafür gibt es die Erstattung.
3. Den Endstatus ansehen. Ein Ereignis activation.expired oder ein abgelaufener Zustand im GET-Aufruf bedeutet, dass keine SMS eintraf und das Geld bereits im Wallet ist.
4. Mit Geduld wiederholen. Versuchen Sie es etwas später noch einmal oder über eine andere Route für denselben Dienst, statt in enger Schleife neu zu bestellen.
5. Den eigenen Auslöser prüfen. Ein Test, der die SMS nie angefordert hat, sieht genauso aus wie ein fehlender Code.

Unser Beitrag zum Verringern fehlgeschlagener OTP-Zustellungen nennt weitere Ursachen, die Sie ausschließen sollten.

Kann ich eine estnische Leitung langfristig behalten, und wie funktioniert die Abrechnung?

Eine per Self-Service buchbare langfristige estnische Nummer gibt es nicht. Dedicated Numbers sind ein Produkt für die USA und Kanada ab $1.95/Monat; benötigt Ihr Team für Estland eine dauerhafte Leitung, schreiben Sie an [email protected], und das Team teilt Ihnen mit, was die lokalen Vorschriften erlauben, ohne Verfügbarkeitszusage.

Die Abrechnung für das OTP-Routing läuft über ein vorausbezahltes USD-Wallet ohne Monatsgebühr und ohne Tarifwahl. Laden Sie es per Karte oder mit USDT oder USDC auf, und jede Aufladung erzeugt eine PDF-Rechnung per E-Mail. Die aktuellen Preise stehen auf der Preisseite, die Endpoint-Referenz in der Dokumentation.

Häufige Fragen

Kann ich den estnischen Registrierungsablauf meiner App ohne lokale SIM testen?

Ja. Bestellen Sie über das OTP Gateway eine +372-Nummer, tragen Sie sie in Ihr Registrierungsformular ein und lesen Sie den Code im Dashboard, über einen Webhook oder den Aktivierungs-Endpoint aus.

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

Verwenden Sie ee als Länderwert in Aktivierungs- und Preisanfragen.

Haben estnische Telefonnummern eine Verkehrsausscheidungsziffer, die ich entfernen muss?

Nein. Estland hat keine Verkehrsausscheidungsziffer, die nationalen Ziffern folgen unverändert auf +372.

Werde ich belastet, wenn kein estnischer Code ankommt?

Nein. Trifft innerhalb des 20-Minuten-Fensters nichts ein oder brechen Sie vorher ab, geht der volle Betrag automatisch zurück in Ihr Wallet.

Kann auch jemand ohne Entwicklerkenntnisse eine Estland-Verifizierungsnummer bestellen?

Ja. Wählen Sie im Dashboard Estland und den Dienst, bestätigen Sie den angezeigten Preis, kopieren Sie die Nummer in die App und warten Sie, bis der Code auf demselben Bildschirm erscheint.

Lässt sich die estnische Integration proben, bevor echtes Guthaben ausgegeben wird?

Bitten Sie den Support, Ihr Entwicklungskonto auf Sandbox umzustellen. Es liefert simulierte Nummern und Codes, sodass der gesamte Ablauf ohne Wallet-Guthaben laufen kann.

Welche Regeln gelten für die Nutzung dieser Nummern?

Beachten Sie die Bedingungen des jeweiligen Dienstes und die Acceptable Use Policy von OTP Route; die Nummern dienen dem Testen und Betreiben Ihrer eigenen legitimen Produkte und Konten.

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.