+27-Verifizierungsabläufe testen: Eine Checkliste für Markteinführungen in Südafrika

Vor der ersten +27-Bestellung: eine kurze Bereitschaftsliste

Haken Sie diese Punkte ab, dann sollte Ihre erste südafrikanische Aktivierung ohne Überraschungen durchlaufen:

1. Wallet aufgeladen. Ein vorausbezahltes USD-Wallet finanziert alles; laden Sie es per Karte oder mit USDT/USDC auf. Ein Abonnement gibt es nicht.
2. Schlüssel ausgestellt. Erzeugen Sie in der Developer-Konsole einen Bearer-Schlüssel (er beginnt mit or_live_). Halten Sie getrennte Schlüssel für CI und Staging bereit, insgesamt bis zu 10.
3. Webhook registriert. Fügen Sie einen HTTPS-Endpoint hinzu und speichern Sie sein Signing-Secret. Bis zu fünf lassen sich registrieren.
4. Nummern-Normalisierer getestet. Füttern Sie ihn mit Eingaben im Stil von 082 123 4567 und bestätigen Sie, dass +2782... ohne die führende 0 herauskommt.
5. Dienst-ID bestätigt. Laden Sie den Katalog über GET /api/v1/services, statt IDs zu raten.
6. Sandbox optional. Der Support kann ein Entwicklungskonto in die Sandbox schalten, sodass simulierte Nummern und Codes durch Ihren Code laufen, bevor echtes Geld fließt.

Der CI-Testleitfaden zeigt, wie sich diese Bausteine in eine Pipeline einbinden lassen.

Wie sollten südafrikanische Nummern gespeichert und normalisiert werden?

Südafrika verwendet die Vorwahl-Null 0. Eine lokal geschriebene Mobilnummer hat zehn Ziffern, etwa 082 123 4567, und Mobilbereiche beginnen in dieser nationalen Form typischerweise mit 06, 07 oder 08. Im internationalen Format verschwindet die 0: Dieselbe Leitung wird zu +27 82 123 4567 bzw. +27821234567, sobald die Leerzeichen entfernt sind – neun Ziffern nach der Landesvorwahl.

Der klassische Fehler ist ein gespeicherter Wert wie +270821234567, der entsteht, wenn ein Formular die Landesvorwahl an die lokale Nummer hängt, ohne die 0 zu entfernen. Normalisieren Sie bei der Eingabe, speichern Sie ausschließlich E.164 und zeigen Sie das lokale Format mit Leerzeichen nur zur Anzeige. Wenn Sie selbst ausgehende SMS versenden, hält dieselbe Regel Zustellberichte und Nutzersuchen konsistent.

Welche Dienste können Codes an eine südafrikanische Verifizierungsnummer senden?

Zu den beliebten Routen für za gehören derzeit WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Uber, Telegram, Microsoft & Outlook, LinkedIn, Netflix, Amazon, X (Twitter), ChatGPT (OpenAI) und Discord. Im gesamten Katalog unterstützt das Land mehr als 1.700 Dienste, und da sich der Bestand im Tagesverlauf ändert, ist die API die Stelle, an der Sie die aktuelle Verfügbarkeit ablesen.

Warum wählen Teams diesen Markt? Johannesburg und Kapstadt sind etablierte Tech- und Finanzzentren, und viele Unternehmen nutzen Südafrika als Basis für eine breitere Einführung im südlichen Afrika. Das Land hat mehrere Amtssprachen, darunter Englisch, isiZulu, isiXhosa und Afrikaans, doch die meisten Verifizierungsnachrichten kommen auf Englisch an, sodass sich die Lokalisierungs-QA eher auf die umgebenden Screens als auf den SMS-Text selbst konzentriert.

Schritte: Die Südafrika-OTP-API aus Ihrem Test-Harness aufrufen

Anfragen gehen mit Ihrem Bearer-Schlüssel an https://otproute.com/api/v1, bis zu 300 pro Minute.

1. GET /api/v1/prices?country=za&service=<id> liefert den aktuellen Preis für die gewünschte Kombination.
2. POST /api/v1/activations mit {"service": "<id>", "country": "za"} reserviert eine +27-Nummer und gibt eine Aktivierungs-ID zurück.
3. Ihr Test trägt die Nummer in der App ein und löst die SMS aus.
4. Das Ereignis activation.sms_received erreicht Ihren Webhook. Bevor Sie ihm vertrauen, berechnen Sie den HMAC-SHA256 von <t>.<raw body> mit dem Endpoint-Secret neu, vergleichen ihn mit v1 in X-OTPRoute-Signature und verwerfen Anfragen, deren Zeitstempel zu alt ist.
5. Lieber pollen? Lesen Sie GET /api/v1/activations/{id} in gemächlichem Intervall.
6. Abgebrochene Läufe sollten POST /api/v1/activations/{id}/cancel aufrufen, und mit GET /api/v1/balance kann ein Job früh stoppen, wenn das Guthaben knapp wird.

Mehr zu Routing-Entscheidungen steht in Länder-Routing für OTP.

Schritte für Betriebsmitarbeitende im Dashboard

Kein Code erforderlich: Öffnen Sie das OTP Gateway, wählen Sie Südafrika und den Dienst, prüfen Sie den angezeigten Preis, bestätigen Sie und fügen Sie die +27-Nummer in die App ein. Die SMS erscheint auf der Aktivierungsseite, sobald sie eintrifft, und das 20-Minuten-Fenster samt automatischer Erstattung funktioniert genauso wie über die API.

Fehlersuche bei hängenden südafrikanischen Codes

Zuerst zum Geld: Trifft innerhalb von 20 Minuten keine SMS ein oder brechen Sie ab, wird der volle Betrag automatisch dem Wallet gutgeschrieben. Danach folgt die Diagnose:

• Zuerst Geduld. Die Zustellgeschwindigkeit hängt vom Dienst und von der Route ab, lassen Sie die Aktivierung daher ausreifen.
• Annahmerichtlinie. Manche Dienste lehnen virtuelle Nummern ab; eine Erstattung ist in diesem Fall erwartetes Verhalten und kein Fehler.
• Anderer Zeitpunkt oder andere Route. Versuchen Sie es später erneut oder nutzen Sie eine Nachbarroute wie Namibia oder Botswana, wenn der Testfall es zulässt.
• Nicht hämmern. Abbrechen und sofort neu bestellen in enger Schleife hilft selten und verbraucht Ihr Rate-Limit.

Nutzen Sie Nummern ausschließlich zum Testen Ihres eigenen Produkts oder zum Betrieb Ihrer eigenen Geschäftskonten, beachten Sie die Bedingungen jedes Dienstes und denken Sie daran, dass die Acceptable Use Policy von OTP Route gilt.

Langfristige südafrikanische Leitungen und das Abrechnungsmodell

Eine selbst buchbare langfristige +27-Nummer gibt es nicht. Dedicated Numbers, ab $1.95/Monat, werden nur in den USA und in Kanada angeboten; Teams, die eine dauerhafte südafrikanische Leitung brauchen, können an [email protected] schreiben, und ob das möglich ist, hängt von lokalen Vorschriften ab. Abgerechnet wird nach Verbrauch aus dem vorausbezahlten Wallet, für jede Aufladung kommt eine PDF-Rechnung per E-Mail. Das Gesamtbild finden Sie unter Preise.

Häufige Fragen

Kann ich den südafrikanischen Registrierungsablauf meiner App ohne lokale SIM testen?

Ja. Bestellen Sie eine +27-Nummer über das OTP Gateway und lesen Sie den Code im Dashboard oder per API ab. Sie kostet ab $0.20 pro Code – und nur dann, wenn der Code eintrifft.

Behalte ich die führende 0, wenn ich eine südafrikanische Nummer in E.164 umwandle?

Nein. Lassen Sie die Vorwahl-0 weg und stellen Sie +27 voran, aus 082 123 4567 wird also +27821234567.

Wie lautet die API-Länder-ID für Südafrika?

Sie lautet za und gehört in die Preisabfrage sowie in den JSON-Body, wenn Sie eine +27-Aktivierung anlegen.

In welcher Sprache sind südafrikanische Verifizierungs-SMS verfasst?

Meist auf Englisch, obwohl das Land mehrere Amtssprachen hat. Den Wortlaut bestimmt der sendende Dienst.

Gibt es eine Erstattung, wenn der Code nie zugestellt wird?

Ja. Die Aktivierung ist 20 Minuten lang offen, und wenn nichts eintrifft oder Sie abbrechen, geht der volle Betrag automatisch an Ihr Wallet zurück.

Kann ich eine südafrikanische Nummer für mehrere Monate kaufen?

Nicht im Self-Service. Dedicated Numbers sind ein Produkt für die USA und Kanada; für Südafrika fragen Sie beim Support per E-Mail an, ohne Zusage zur Verfügbarkeit.

Wie viele Dienste kann ich bei OTP Route mit einer +27-Nummer verifizieren?

Laut der jüngsten Momentaufnahme mehr als 1.700. Prüfen Sie den Live-Katalog über die API, da sich die Verfügbarkeit im Tagesverlauf ändert.

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.