Indonesische +62-OTP-Codes programmatisch einsammeln

Welche Endpunkte ruft eine Indonesien-OTP-API-Integration auf?

Alles läuft gegen https://otproute.com/api/v1 mit einem Bearer-Schlüssel mit dem Präfix or_live_. Erstellen Sie ihn in der Developer-Konsole; ein Konto kann bis zu 10 Schlüssel halten, was es leicht macht, einen CI-Runner von einem Staging-Rechner zu trennen.

1. Rufen Sie GET /api/v1/services und GET /api/v1/countries ab und speichern Sie beide Listen zwischen. Indonesien erscheint mit der ID id.
2. Fragen Sie GET /api/v1/prices?country=id&service=<id> nach aktuellem Preis und Verfügbarkeit des Dienstes ab, den Sie gleich testen. Der Bestand bewegt sich im Tagesverlauf, fragen Sie ihn also pro Lauf ab, statt ihn fest zu codieren.
3. Legen Sie die Bestellung mit POST /api/v1/activations und einem Body wie {"service": "tokopedia", "country": "id"} an. Sie erhalten eine Aktivierungs-ID und eine +62-Nummer zurück.
4. Tippen oder injizieren Sie diese Nummer in das Telefonfeld Ihrer eigenen App oder Ihres Testkontos.
5. Lesen Sie das Ergebnis über einen Webhook oder durch Abfragen von GET /api/v1/activations/{id}. Brechen Sie sauber mit POST /api/v1/activations/{id}/cancel ab, wenn ein Test vor dem SMS-Schritt scheitert.

Ein kurzer GET /api/v1/balance vor dem Start der Suite lässt einen Lauf früh scheitern statt mittendrin. Polling in sinnvollem Intervall passt problemlos unter die Obergrenze von 300 Anfragen pro Minute. Die vollständigen Schemata finden Sie in der API-Dokumentation.

Wie verarbeite ich +62-Codes mit einem signierten Webhook?

Polling genügt für einen einzelnen Entwickler; parallele Jobs laufen mit Push-Zustellung ruhiger. Registrieren Sie bis zu 5 Endpunkte pro Konto und abonnieren Sie activation.sms_received, activation.expired und activation.cancelled.

Jede Anfrage enthält einen X-OTPRoute-Signature-Header in der Form t=<unix>,v1=<hex>. Bauen Sie den signierten String als <t>.<raw body> nach, berechnen Sie HMAC-SHA256 mit dem Endpoint-Secret und vergleichen Sie ihn in konstanter Zeit mit v1. Hashen Sie die rohen Bytes vor jedem JSON-Parsing und verwerfen Sie Anfragen mit zu altem Zeitstempel, damit eine abgefangene Nutzlast nicht erneut eingespielt werden kann.

Behandeln Sie Ereignisse als über die Aktivierungs-ID zugeordnet und machen Sie den Handler idempotent: Eine wiederholte Zustellung sollte den Code einfach schon gespeichert vorfinden. Unser Beitrag zur HMAC-Webhook-Sicherheit geht die Prüfungen durch.

Welche Dienste können bei OTP Route indonesische SMS-OTP empfangen?

Der Live-Snapshot für Indonesien umfasst mehr als 3.000 Dienste. Beliebte Routen sind WhatsApp, Tokopedia, Shopee, Lazada, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LINE, Discord, Microsoft & Outlook und ChatGPT (OpenAI).

Für Kollegen, die die API nie anfassen, erledigt das Dashboard dieselbe Aufgabe: anmelden, Dienst wählen, Indonesien wählen, den angezeigten Preis prüfen und bestellen. Die +62-Nummer erscheint auf dem Bildschirm, und der Code wird daneben angezeigt, sobald die SMS eingeht. Brechen Sie in derselben Ansicht ab, wenn der Test abgesagt wird.

Wie sollte eine +62-Nummer gespeichert und normalisiert werden?

Indonesien verwendet das Ortsnetz-Präfix 0, daher schreibt man Mobilnummern im Inland als 08 gefolgt von den übrigen Ziffern. In E.164 entfällt die 0: Eine lokal als 0812... geschriebene Nummer wird zu +62812.... Speichern Sie die E.164-Form, normalisieren Sie alles, was ein Nutzer tippt, indem Sie Leerzeichen, Bindestriche und die führende 0 entfernen, und überlassen Sie die Gültigkeitsprüfung einer gepflegten Telefonnummern-Bibliothek, denn indonesische Teilnehmernummern haben nicht alle dieselbe Länge.

An indonesische Nummern gesendete SMS-Vorlagen sind häufig auf Bahasa Indonesia, manche Dienste senden jedoch Englisch. Extrahieren Sie den Code über ein Ziffernmuster, statt Wörter wie „kode“ oder „code“ zu suchen, dann ist Ihrem Parser die Sprache der Vorlage egal.

Warum testen Produktteams Registrierungsabläufe in Indonesien?

Indonesien gehört zu den bevölkerungsreichsten Ländern der Welt, und die Internetnutzung ist stark mobil geprägt, weshalb die Telefonnummern-Verifizierung am Anfang vieler Onboarding-Abläufe steht. Teams, die nach Südostasien expandieren, wollen sehen, dass sich ihre eigenen indonesischen Registrierungs- und Anmeldebildschirme mit einer echten +62-Nummer korrekt verhalten, prüfen, dass Texte in Bahasa Indonesia ohne Abschneiden dargestellt werden, und bestätigen, dass ihre Betrugsregeln legitime lokale Nutzer nicht blockieren.

Auch regionale Betriebs- und Marktplatz-Teams nutzen die Route, um Geschäftskonten zu verifizieren, die sie für indonesische Shops verwalten. Die Seite zu QA-Tests beschreibt, wie sich das in einen Regressionsplan einfügen lässt.

Was, wenn der indonesische Code nie erscheint?

Die Zustellzeit hängt vom Dienst und von der Route ab, geben Sie der Aktivierung also Spielraum, bevor Sie sie für gescheitert halten. Kommt keine SMS an:

• Lassen Sie das 20-Minuten-Fenster ablaufen oder brechen Sie ab; in beiden Fällen geht der volle Betrag automatisch auf Ihr Guthaben zurück.
• Bestellen Sie etwas später erneut oder probieren Sie eine andere Dienstroute, wenn Ihr Test es zulässt.
• Bestätigen Sie, dass der Zieldienst für diese Aktion virtuelle Nummern akzeptiert. Manche tun es nicht, und genau deshalb gibt es die Erstattungsregel.
• Vermeiden Sie Neubestellungen in enger Schleife. Legen Sie zwischen den Versuchen ein Backoff ein, damit ein CI-Job nicht in Sekunden alle Wiederholungen verbraucht.

Weitere Diagnoseideen finden Sie unter Fehlgeschlagene OTP-Zustellungen reduzieren.

Gibt es eine dedizierte +62-Nummer, und wie wird sie abgerechnet?

Nein. Eine langfristige indonesische Leitung im Self-Service wird nicht angeboten. Dedizierte Nummern sind ein Produkt für die Vereinigten Staaten und Kanada, ab $1.95/Monat. Braucht Ihr Team wirklich eine dauerhafte +62-Leitung, schreiben Sie an [email protected]; ob sich eine einrichten lässt, hängt von den lokalen Vorschriften ab und wird nicht zugesagt.

Die Abrechnung für das OTP Gateway nutzt ein einziges prepaid USD-Guthaben ohne Monatsgebühr und ohne Tarif zur Auswahl. Laden Sie das Guthaben per Karte oder mit den Stablecoins USDT/USDC auf; jede Aufladung löst eine PDF-Rechnung per E-Mail für Ihre Finanzunterlagen aus. Entwicklungskonten können den Sandbox-Modus anfordern, der simulierte Nummern und Codes für Ende-zu-Ende-Integrationstests liefert, ohne Guthaben auszugeben. Siehe Preise oder Konto erstellen.

Häufige Fragen

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

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

Welche Länder-ID verwendet die OTP Route API für Indonesien?

Indonesien ist id, eine Preisabfrage lautet also GET /api/v1/prices?country=id&service=<id>.

Zahle ich, wenn die indonesische SMS nie ankommt?

Nein. Geht innerhalb des 20-Minuten-Fensters nichts ein oder brechen Sie ab, wird die gesamte Abbuchung automatisch auf Ihr Guthaben zurückgebucht.

Sollte ich die führende 0 behalten, wenn ich eine indonesische Mobilnummer speichere?

Behalten Sie sie nur für die Anzeige im lokalen Format. Speichern Sie +62 gefolgt von der nationalen Nummer ohne die 0, das ist die E.164-Form.

Sind indonesische Verifizierungstexte auf Englisch?

Nicht immer. Viele kommen auf Bahasa Indonesia, parsen Sie daher den numerischen Code, statt sich auf umgebende Wörter zu verlassen.

Sind indonesische Nummern für jeden Zweck erlaubt?

Nur für legitime Nutzung: Testen und Betreiben Ihrer eigenen Produkte und Konten im Rahmen der Bedingungen des jeweiligen Dienstes. Für jede Bestellung gilt die Richtlinie zur akzeptablen Nutzung von OTP Route.

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.