+387-Registrierungen verifizieren, wenn niemand im Team eine bosnische SIM hat

Unser Release braucht einen +387-Test, aber die SIM liegt in einer Schublade in Sarajevo. Was nun?

Das ist eine verbreitete Zwickmühle für Teams, die auf den Westbalkan ausliefern. Der Product Manager will den Beweis, dass bosnische Nutzer sich registrieren können, die QA-Leitung hat einen Checklistenpunkt „mit einer lokalen Nummer verifizieren“, und die einzige physische +387-SIM gehört einem Kollegen, der im letzten Frühjahr gegangen ist.

Die üblichen Gründe, warum ein Team hier landet:

• Ein regionaler Launch in Bosnien und Herzegowina neben Kroatien, Serbien und Montenegro, bei dem der Registrierungspfad jedes Marktes eine eigene Prüfung braucht.
• Kunden in der Diaspora. Viele Menschen in Deutschland, Österreich, Schweden und anderswo behalten eine +387-Nummer, sodass ein Fintech- oder telekomnahes Produkt bosnische Nummern von Nutzern sieht, die das Land beim Onboarding nie betreten haben.
• Lokalisierungs-QA. Bosnisch, Kroatisch und Serbisch sind allesamt Amtssprachen, und im Alltag kommen sowohl lateinische als auch kyrillische Schrift vor, sodass Texte und Formularvalidierung einen echten End-to-End-Durchlauf verdienen.

Statt SIM-Karten durch die Gegend zu schicken, übernimmt OTP Route das OTP-Routing für Sie: Das OTP Gateway liefert Ihnen eine +387-Nummer für eine einzelne Verifizierung und reicht die eingehende SMS über eine SMS-Verifizierungs-API zurück, die Ihr Test-Harness aufrufen kann.

Welche Apps und Plattformen können Codes an eine bosnische Verifizierungsnummer senden?

Die Abdeckung ist eine Momentaufnahme, sehen Sie dies also als Ausgangspunkt und nicht als feste Speisekarte. Zum Zeitpunkt des Schreibens umfassen die Routen für Bosnien und Herzegowina Viber, WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, Microsoft & Outlook, LinkedIn, Discord, Uber, Amazon und eBay.

Insgesamt bietet das Land mehr als 1.600 Dienste. Brauchen Sie eine Verifizierungsnummer für Bosnien und Herzegowina für einen hier nicht aufgeführten Dienst, prüfen Sie zuerst die Live-Liste. Viber ist auf dem Balkan wichtiger als in vielen anderen Regionen, was sich lohnt zu bedenken, falls Ihr eigenes Produkt Codes auch über Messaging-Kanäle und nicht nur per SMS versendet. Da sich die Verfügbarkeit im Tagesverlauf ändert, fragen Sie die API nach den aktuellen Optionen, statt eine Liste fest in Ihre Testsuite zu schreiben.

Wie läuft der OTP-API-Ablauf für Bosnien und Herzegowina, Aufruf für Aufruf?

Richten Sie Ihren Client für bosnische Tests auf https://otproute.com/api/v1 und übergeben Sie einen or_live_-Key als Bearer-Token. Keys werden in der Developer-Konsole erstellt; ein Konto kann bis zu 10 Keys und 5 Webhook-Endpunkte halten, mit einer Obergrenze von 300 Anfragen pro Minute.

1. Rufen Sie GET /api/v1/services und GET /api/v1/countries einmal auf, cachen Sie die IDs und bestätigen Sie, dass ba aufgeführt ist.
2. Prüfen Sie die Kosten mit GET /api/v1/prices?country=ba&service=<id>, damit Ihr Job den genauen Betrag protokolliert, bevor etwas ausgegeben wird.
3. Senden Sie POST /api/v1/activations mit {"service": "<id>", "country": "ba"}. Die Antwort enthält die Aktivierungs-ID und die +387-Nummer, die Sie in die getestete App eintippen.
4. Warten Sie auf den Webhook activation.sms_received oder fragen Sie GET /api/v1/activations/{id} in moderatem Intervall per Polling ab, falls Ihr Runner keinen eingehenden Verkehr annehmen kann.
5. Bricht der Test ab, geben Sie die Nummer mit POST /api/v1/activations/{id}/cancel frei, damit das Guthaben sofort zurückfließt.

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 in konstanter Zeit und verwerfen Sie veraltete Zeitstempel. Da Ereignisse über die Aktivierungs-ID zugeordnet sind, sollte ein doppelt zugestellter +387-Code nur einmal gespeichert werden. Der Leitfaden zur OTP-API-Integration behandelt Wiederholungen und Fehlerbehandlung ausführlicher.

Gibt es einen Weg ohne Code für das Support- oder Ops-Team?

Ja. Wer keinen API-Zugang hat, kann dasselbe im Browser tun: Anmelden, das OTP Gateway öffnen, Bosnien und Herzegowina und den Dienst wählen, den Preis ansehen und bestätigen. Die Nummer erscheint auf dem Bildschirm, und der Code taucht daneben auf, sobald die SMS eingegangen ist. Das passt für einen Support-Mitarbeiter, der ein Registrierungsproblem eines Kunden nachstellt, oder für eine Operations-Leitung, die nach einem Telefonwechsel ein Partnerportal prüft.

Wie speichern wir +387-Nummern und werten bosnische SMS-Texte aus?

Im Inland werden bosnische Nummern mit dem Netzpräfix 0 gewählt, und Mobilnummern beginnen typischerweise mit 06. Im E.164-Format entfällt diese Null: Eine lokal als 061 gefolgt von sechs Ziffern geschriebene Nummer wird zu +387 61 plus diesen sechs Ziffern. Speichern Sie nur die E.164-Form, entfernen Sie bei der Eingabe Leerzeichen, Bindestriche und Schrägstriche und lehnen Sie alles ab, was nach der Landesvorwahl noch die führende Null trägt.

Verifizierungstexte können auf Englisch oder in einer der Landessprachen eintreffen, und auch eine Nachricht in kyrillischer Schrift ist durchaus möglich. Extrahieren Sie den Code über ein Ziffernmuster statt über die Suche nach einem bestimmten Wort, und achten Sie darauf, dass Ihr Logging UTF-8 intakt lässt, damit Diakritika wie č, ć, š und ž beim Debuggen eines fehlgeschlagenen Laufs nicht zerstört werden.

Was, wenn ein Testlauf den Code nie erhält?

Wenn ein Code nicht ankommt, wird nichts berechnet. Geht innerhalb von 20 Minuten keine SMS ein oder brechen Sie vorher ab, wird der volle Betrag automatisch Ihrem Guthaben gutgeschrieben. Wenn das passiert:

• Lassen Sie das Fenster ablaufen, statt sofort neu zu bestellen; eine verspätete SMS zählt trotzdem.
• Versuchen Sie es etwas später erneut oder wählen Sie für dasselbe Szenario eine andere Dienstroute.
• Prüfen Sie, ob der Zieldienst überhaupt virtuelle Nummern akzeptiert; manche lehnen sie ab, und genau deshalb gibt es die Erstattung.
• Vermeiden Sie enge Bestellschleifen aus der CI, die das Ratelimit verbrauchen, ohne die Chancen zu verbessern.

Fehlgeschlagene OTP-Zustellungen reduzieren behandelt die Muster, die erfahrungsgemäß helfen.

Können wir eine bosnische Nummer langfristig behalten, und wie funktioniert die Abrechnung?

Nicht als selbst buchbares Produkt. Dedicated Virtual Numbers, die sich ab $1.95/Monat aus dem Guthaben verlängern, werden nur für die USA und Kanada sofort verkauft. Braucht Ihr Team wirklich eine langfristige +387-Nummer, schreiben Sie an [email protected]; ob eine möglich ist, hängt von den lokalen Vorschriften ab, und es gibt keine Zusage, dass sie sich einrichten lässt.

Das Gateway wird über ein einziges vorausbezahltes USD-Guthaben abgerechnet, ohne Monatsgebühr und ohne Tarifwahl. Guthaben lässt sich per Karte oder mit den Stablecoins USDT/USDC aufladen; zu jeder Einzahlung landet eine PDF-Rechnung in Ihrem Postfach. Für Integrationsarbeit kann ein Entwicklungskonto auf Anfrage auf Sandbox umgestellt werden und liefert simulierte Nummern und Codes, sodass Ihre Pipeline läuft, ohne Guthaben anzutasten. Aktuelle Preise stehen auf der Preisseite, und Sie können ein Konto erstellen mit E-Mail-Code oder Google-Anmeldung.

Häufige Fragen

Kann ich den bosnischen Registrierungsablauf meiner App ohne lokale SIM-Karte testen?

Ja. Bestellen Sie über das OTP Gateway eine +387-Nummer für Ihren Dienst, geben Sie sie in Ihrer App ein und lesen Sie den Code im Dashboard oder über die API aus.

Welche Länder-ID verwendet OTP Route für Bosnien und Herzegowina?

Die ID lautet ba. Übergeben Sie sie als Feld country, wenn Sie eine Aktivierung anlegen, und als Query-Parameter country, wenn Sie Preise abfragen.

Muss ich zahlen, wenn der +387-Code nie ankommt?

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

Soll ich beim Speichern einer bosnischen Mobilnummer die führende Null behalten?

Nein. Speichern Sie Nummern im E.164-Format, also +387 gefolgt von der Nummer ohne die nationale Netzpräfix-Null.

Eignet sich eine +387-Testnummer für ein Konto, in das wir uns nächsten Monat erneut einloggen müssen?

Eher nicht, denn jede Gateway-Nummer deckt eine Verifizierung ab. Für wiederholte Logins ist eine Dedicated Number in den USA oder Kanada die selbst buchbare Option; für eine bosnische Langzeitnummer fragen Sie das Team per E-Mail.

Kann ich bosnische OTP-Tests in der CI ohne Kosten ausführen?

Ja, indem Sie den Sandbox-Modus für ein Entwicklungskonto anfragen. Er liefert simulierte Nummern und Codes, sodass der gesamte Ablauf einschließlich Webhooks kostenlos durchgespielt werden kann.

Gibt es Regeln dafür, wie diese Nummern verwendet werden dürfen?

Ja. Halten Sie sich an die Bedingungen des jeweiligen Dienstes, nutzen Sie die Nummern nur für Ihre eigenen legitimen Produkte und Konten und beachten Sie, dass die Acceptable Use Policy von OTP Route für jede Bestellung 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.