+966-Verifizierungscodes programmatisch empfangen für Saudi-Launches

Wie sieht eine einzelne +966-Aktivierung über die API aus?

Beginnen wir mit den Aufrufen, denn die meisten Leser dieser Seite binden eine SMS-Verifizierungs-API in eine Testsuite oder ein internes Tool ein. Alle Endpunkte liegen unter https://otproute.com/api/v1 und erwarten einen Bearer-Key mit dem Präfix or_live_, erzeugt in der Developer-Konsole.

1. GET /api/v1/countries und GET /api/v1/services liefern die IDs. Saudi-Arabien ist sa.
2. GET /api/v1/prices?country=sa&service=<id> gibt den aktuellen Preis für diese Kombination zurück; protokollieren Sie ihn neben dem Testlauf.
3. POST /api/v1/activations mit {"service": "<id>", "country": "sa"} liefert eine Aktivierungs-ID und eine +966-Nummer.
4. Ihr Test trägt die Nummer in die App ein, und der Code kommt als Ereignis oder über GET /api/v1/activations/{id}.
5. Wird der Test abgebrochen, gibt POST /api/v1/activations/{id}/cancel die Nummer frei und erstattet das Wallet.

GET /api/v1/balance eignet sich als Vorabprüfung, damit ein nächtlicher Job früh mit einer klaren Meldung scheitert statt mitten im Lauf. Limits, mit denen Sie planen sollten: 10 Keys und 5 Webhook-Endpunkte pro Konto, 300 Anfragen pro Minute.

Wie sollte unser Webhook-Empfänger saudische OTP-Ereignisse behandeln?

Registrieren Sie einen Endpunkt und abonnieren Sie activation.sms_received, activation.expired und activation.cancelled. Jede Anfrage enthält X-OTPRoute-Signature in der Form t=<unix>,v1=<hex>.

• Bilden Sie den signierten String als <t>.<raw body> und berechnen Sie HMAC-SHA256 mit dem Secret dieses Endpunkts.
• Vergleichen Sie mit v1 über eine zeitkonstante Funktion und weisen Sie alles zurück, dessen Zeitstempel zu alt ist.
• Behandeln Sie jedes Ereignis als an die Aktivierungs-ID gebunden, damit eine erneute Zustellung nichts doppelt aktualisiert.
• Antworten Sie schnell mit 2xx und erledigen Sie aufwendige Arbeit in einem Hintergrundjob.

Polling bleibt eine gültige Alternative für Runner, die keine eingehenden Verbindungen annehmen können. Unsere Beiträge zu webhook-basiertem OTP-Empfang und zum Absichern von OTP-Webhooks mit HMAC gehen weiter ins Detail.

Warum testen Produktteams mit einer +966-Nummer?

Saudi-Arabien ist einer der größeren digitalen Märkte am Golf, und Teams kommen aus praktischen Gründen auf diese Seite: eine Fintech, die das Onboarding für Einwohner Saudi-Arabiens vorbereitet, ein Marktplatz mit neuen Verkäufern aus der Golfregion, ein SaaS-Anbieter, dessen Kunde eine regionale Anmeldeprüfung verlangt, oder ein Betriebsteam, das Geschäftskonten für ein Büro in Riad oder Dschidda verwaltet. In jedem Fall muss jemand beweisen, dass der Ablauf mit einer echten saudischen Verifizierungsnummer funktioniert, und OTP-Routing über das Gateway erspart den Versand von SIM-Karten in die Region. Die Seite zum Fintech-Onboarding beschreibt dieses Szenario genauer.

Welche Dienste können Codes auf saudischen Routen empfangen?

Der Live-Stand für Saudi-Arabien umfasst mehr als 1.000 Dienste. Häufig genutzt werden Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail & YouTube), Telegram, Amazon, Microsoft & Outlook, LinkedIn, Discord und Netflix. Snapchat und X haben im Königreich besonders große Nutzerschaften, weshalb sie oft auf Lokalisierungs-Checklisten stehen. Der Bestand ändert sich im Tagesverlauf, fragen Sie die API daher zur Laufzeit ab.

Wie formatiere ich +966-Nummern und werte arabische Nachrichten aus?

Lokal werden saudische Mobilnummern mit einer Vorwahl-0 geschrieben, meist als 05 gefolgt von acht Ziffern. Die internationale Form lässt diese Null weg: +966 5 und die übrigen acht Ziffern. Normalisieren Sie alles schon bei der Eingabe auf E.164 und entfernen Sie die Null, wenn ein Nutzer sie nach der Landesvorwahl tippt.

Arabisch ist Amtssprache, daher können Verifizierungs-SMS auf Arabisch, Englisch oder in beiden Sprachen eintreffen. Arabisch wird von rechts nach links geschrieben, und manche Vorlagen verwenden arabisch-indische Ziffern statt westlicher Zahlen. Ein Parser, der diese Ziffern vor dem Abgleich in ASCII umwandelt und rohes UTF-8 protokolliert, vermeidet eine ärgerliche Klasse falscher Fehlschläge.

Gibt es einen Dashboard-Weg für Leute ohne Programmierkenntnisse?

Ja. Melden Sie sich bei OTP Route an, öffnen Sie das OTP Gateway, wählen Sie Saudi-Arabien und den Dienst, prüfen Sie den Preis und bestätigen Sie. Die Nummer erscheint sofort, und der Code wird daneben angezeigt, sobald er eintrifft. Ein Support-Mitarbeiter kann so das Registrierungsproblem eines Kunden in wenigen Minuten nachstellen.

Was, wenn der Code nie ankommt, und wie steht es um Langzeitnummern und Abrechnung?

Trifft innerhalb von 20 Minuten keine SMS ein oder stornieren Sie, geht der volle Betrag automatisch zurück ins Wallet. Lassen Sie das Fenster ablaufen, versuchen Sie es später oder über eine andere Dienstroute erneut, prüfen Sie, ob der Dienst virtuelle Nummern akzeptiert, und vermeiden Sie Neubestellungen in enger Schleife.

Eine selbst buchbare saudische Langzeitnummer gibt es nicht. Dedicated Virtual Numbers werden nur in den USA und Kanada angeboten, ab $1.95/month; für eine langfristige +966-Leitung schreiben Sie an [email protected], wohl wissend, dass lokale Vorschriften entscheiden, ob das möglich ist.

Die Finanzierung läuft über ein vorausbezahltes USD-Wallet, pay as you go, ohne Monatsgebühr. Aufladungen funktionieren per Karte und mit USDT/USDC, und jede erzeugt eine per E-Mail versandte PDF-Rechnung. Ein Entwicklungskonto kann auf Anfrage auf Sandbox umgestellt werden und liefert dann simulierte Nummern und Codes. Aktuelle Preise finden Sie auf der Preisseite.

Häufige Fragen

Wie empfange ich eine saudische SMS-OTP über eine API?

Erstellen Sie eine Aktivierung mit dem Land sa und Ihrer Service-ID und entnehmen Sie den Code dem Webhook activation.sms_received oder fragen Sie die Aktivierung per Polling ab.

Wird eine +966-Testnummer berechnet, wenn der Code ausbleibt?

Nein. Fehlt der Code, geht der volle Betrag zurück ins Wallet, wenn das 20-Minuten-Fenster endet oder Sie stornieren.

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

Ja. Das OTP Gateway stellt eine +966-Nummer für einen Code aus, die Sie in Ihre App eintragen und über Dashboard oder API zurücklesen.

Wie speichere ich eine saudische Mobilnummer, die als 05XXXXXXXX eingegeben wurde?

Lassen Sie die Null weg und speichern Sie sie in E.164 als +966 5 plus die übrigen acht Ziffern.

Können wir dieselbe saudische Nummer für spätere Logins behalten?

Nicht mit einem selbst buchbaren Produkt, denn langfristige Dedicated Numbers gibt es nur für die USA und Kanada. Schreiben Sie dem Team, wenn Sie eine saudische Leitung brauchen, ohne Zusicherung, dass sie bereitgestellt werden kann.

Kann ich den saudischen Ablauf proben, bevor echtes Geld im Spiel ist?

Ja. Fordern Sie den Sandbox-Modus für ein Entwicklungskonto an, um simulierte Nummern und Codes samt Webhooks zu erhalten.

Welche Nutzung erlaubt OTP Route?

Tests und den Betrieb Ihrer eigenen legitimen Produkte und Konten. Beachten Sie die Bedingungen jedes Dienstes; die Acceptable Use Policy von OTP Route 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.