Telefonverifizierung in Burundi testen, ganz ohne lokale SIM-Karte

Warum ist ein +257-Registrierungsablauf aus dem Ausland so schwer zu prüfen?

Stellen Sie sich ein Produktteam vor, das Burundi in einen Rollout für Ostafrika aufnimmt. Der Registrierungsbildschirm fragt nach einer Telefonnummer, das Backend sendet einen Einmalcode, und niemand im Team besitzt eine burundische SIM-Karte. Auf Reisen gekaufte Roaming-SIMs laufen ab, und eine Kollegin in Bujumbura zu bitten, Codes vorzulesen, legt eine private Nummer offen und lässt sich nicht in einer nächtlichen Testsuite abbilden.

OTP-Routing beseitigt diesen Engpass. Statt eines physischen Geräts fordern Sie eine Verifizierungsnummer für Burundi für einen bestimmten Dienst an, OTP Route fängt den Code ab, und Ihr Test-Harness liest ihn wie jedes andere Ereignis. Derselbe Ansatz funktioniert für Operations-Teams, die Geschäftsprofile auf burundischen Routen verwalten und dabei ihre eigenen Telefone heraushalten wollen.

Welche Dienste können heute mit einer Burundi-Nummer verifizieren?

Die Live-Momentaufnahme für Burundi listet bekannte Messaging-, Such- und Commerce-Apps, darunter WhatsApp, Viber, imo, Telegram, Signal, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, ChatGPT (OpenAI), Uber und Amazon. Insgesamt deckt die Route mehr als 1.000 Dienste ab.

Der Bestand ändert sich im Tagesverlauf, verstehen Sie diese Liste also als Ausgangspunkt und nicht als Zusage. Ihr Code sollte GET /api/v1/services und GET /api/v1/countries für den aktuellen Stand abfragen, und das vollständige Verzeichnis lässt sich unter Länder durchsuchen.

Wie fügt sich die Burundi-OTP-API in einen Testlauf ein?

Erstellen Sie in der Developer-Konsole einen Schlüssel; Live-Schlüssel beginnen mit or_live_ und gehören in einen Bearer-Header gegenüber https://otproute.com/api/v1. Eine typische automatisierte Prüfung sieht dann so aus:

1. Rufen Sie GET /api/v1/prices?country=bi&service=whatsapp auf, um den aktuellen Preis dieser Kombination zu lesen.
2. Senden Sie POST /api/v1/activations mit dem Body {"service": "whatsapp", "country": "bi"}. Die Antwort enthält eine Aktivierungs-ID und die +257-Nummer, die Sie in die zu testende App eingeben.
3. Warten Sie auf den Webhook activation.sms_received oder fragen Sie GET /api/v1/activations/{id} in einem sinnvollen Intervall ab.
4. Prüfen Sie den Code per Assertion und schließen Sie den Test ab.

Webhook-Anfragen enthalten X-OTPRoute-Signature: t=<unix>,v1=<hex>, ein HMAC-SHA256 über <t>.<raw body> mit dem Endpunkt-Secret als Schlüssel. Berechnen Sie ihn neu, vergleichen Sie in konstanter Zeit und verwerfen Sie veraltete Zeitstempel; diese Anleitung behandelt die Details. Ein Konto kann bis zu 10 Schlüssel und 5 Webhook-Endpunkte halten, bei einer Obergrenze von 300 Anfragen pro Minute. Vollständige Referenz: Dokumentation.

Was sollte mein Validator bei einer burundischen Nummer erwarten?

Burundi verwendet einen geschlossenen Nummerierungsplan: Teilnehmernummern haben acht Ziffern nach der Landesvorwahl, und es gibt kein nationales Trunk-Präfix, das entfernt werden müsste. Im E.164-Format ergibt das +257 gefolgt von acht Ziffern, ohne Leerzeichen gespeichert. Formulare zeigen sie oft in Zweiergruppen an, normalisieren Sie Eingaben also, indem Sie Leerzeichen, Bindestriche und ein führendes 00 vor dem Speichern entfernen.

Ein häufiger Fehler ist ein Validator, der für neun- oder zehnstellige nationale Nummern geschrieben wurde und gültige +257-Eingaben stillschweigend ablehnt. Nehmen Sie eine Fixture mit dieser Länge in Ihre Unit-Tests auf.

Kirundi, Französisch und Englisch sind Amtssprachen, und im Handel wird weithin Suaheli gesprochen. Verifizierungstexte globaler Apps kommen meist auf Englisch oder Französisch an, je nach Locale-Logik des Absenders; werten Sie daher die Ziffern aus, statt auf den Wortlaut zu prüfen.

Der Code kam nicht an: Was nun?

Jede Aktivierung bleibt 20 Minuten offen. Erreicht in dieser Zeit keine SMS die Nummer oder brechen Sie mit POST /api/v1/activations/{id}/cancel ab, wird der volle Betrag automatisch Ihrem Guthaben gutgeschrieben.

• Lassen Sie das Fenster laufen, bevor Sie von einem Fehlschlag ausgehen; manche Absender stellen Nachrichten in eine Warteschlange.
• Prüfen Sie, ob der Zieldienst virtuelle Nummern überhaupt akzeptiert, denn manche lehnen sie per Richtlinie ab.
• Versuchen Sie es später erneut oder testen Sie denselben Ablauf über eine andere Dienstroute.
• Vermeiden Sie Neubestellungen in einer engen Schleife; halten Sie zwischen den Versuchen Abstand.

Lieber im Dashboard? Melden Sie sich an, wählen Sie Burundi und den Dienst, kopieren Sie die Nummer in die App und sehen Sie zu, wie der Code auf dem Bildschirm erscheint. Weitere Taktiken stehen in Fehlgeschlagene OTP-Zustellungen verringern.

Können wir eine burundische Leitung für Konten behalten, bei denen wir uns wiederholt anmelden?

Nicht als Self-Service-Produkt. OTP Route verkauft keine langfristigen Nummern für Burundi; das OTP Gateway vergibt pro Verifizierung eine Nummer. Wenn Ihr Team dort wirklich eine dauerhafte Leitung braucht, schreiben Sie an [email protected] und schildern Sie den Anwendungsfall; die Verfügbarkeit hängt von den lokalen Vorschriften ab und ist nicht zugesichert.

Dedicated Virtual Numbers gibt es nur in den Vereinigten Staaten und Kanada, ab $1.95/Monat, mit eingehenden SMS, Webhook-Weiterleitung und Telefonie im Browser. Siehe virtuelle Nummern, falls eine US-amerikanische oder kanadische Leitung zu Ihren Staging-Konten passt.

Wie wird die Nutzung für Burundi abgerechnet?

Es gibt ein einziges vorausbezahltes USD-Guthaben ohne monatliche Gebühr und ohne Tarifwahl. Aufgeladen wird per Karte oder mit USDT/USDC-Stablecoins; die Buchhaltung erhält zu jeder Aufladung eine PDF-Rechnung per E-Mail. Bevor Sie Zahlungen in die CI einbinden, beantragen Sie die Umstellung eines Entwicklungskontos auf Sandbox, das simulierte Nummern und Codes liefert, ohne das Guthaben anzutasten.

Verwenden Sie jede Nummer nur für Ihr eigenes Produkt oder legitime Geschäftskonten, beachten Sie die Bedingungen jedes Dienstes und denken Sie daran, dass die Acceptable Use Policy von OTP Route gilt. Aktuelle Preise finden Sie unter Preise.

Häufige Fragen

Kann ich den Registrierungsablauf meiner App für Burundi ohne lokale SIM-Karte testen?

Ja. Bestellen Sie im OTP Gateway eine +257-Nummer für Ihren Dienst, geben Sie sie in der App ein und lesen Sie den Code im Dashboard, über die API oder per Webhook.

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

Übergeben Sie bi als Länderwert, zum Beispiel in POST /api/v1/activations zusammen mit einer Service-ID wie telegram.

Werden mir Kosten berechnet, wenn der +257-Code nie ankommt?

Nein. Kommt innerhalb des 20-Minuten-Fensters nichts an oder brechen Sie ab, wird der volle Betrag automatisch Ihrem Guthaben gutgeschrieben.

Haben burundische Nummern eine führende Null, die entfernt werden muss?

Nein. Burundi hat kein Trunk-Präfix, die E.164-Form ist also einfach +257 plus acht Ziffern.

In welcher Sprache ist eine Verifizierungs-SMS aus Burundi geschrieben?

Das hängt vom sendenden Dienst ab, üblich sind aber Englisch oder Französisch. Extrahieren Sie den numerischen Code, statt sich auf den Nachrichtentext zu verlassen.

Kann ich dieselbe Burundi-Nummer nächsten Monat wiederverwenden?

Nein. Gateway-Nummern dienen einer einzigen Verifizierung. Für wiederholte Anmeldungen gibt es eine Dedicated Number, allerdings nur in den USA und Kanada.

Was kostet eine Verifizierungsnummer für Burundi?

Die Preise für Burundi beginnen ab $0.20 pro Code, der genaue Wert richtet sich nach dem Dienst. Er wird von GET /api/v1/prices zurückgegeben und vor der Bestellung angezeigt.

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.