Salvadorianische (+503) Verifizierungscodes für QA- und Launch-Teams

Einmalcode oder Dauerleitung: was braucht ein salvadorianischer Test?

Beginnen Sie mit der Form des Tests, denn sie entscheidet über das Produkt.

• Ein einzelner Verifizierungsschritt (Registrierung, Telefonnummernwechsel, eine Step-up-Prüfung) gehört zum OTP Gateway. Sie bestellen eine +503-Nummer für einen Dienst, der Code kommt einmal an, und die Nummer ist erledigt.
• Ein Konto, das sich über Wochen immer wieder anmelden muss, braucht eine Leitung, die Ihnen gehört. Dedicated Numbers sind ein Produkt für die USA und Kanada ab $1.95/month, sofort im Dashboard buchbar, mit eingehenden SMS, ausgehenden SMS und Telefonie im Browser.

Für El Salvador gibt es keine Dedicated Number im Self-Service. Braucht Ihr Team wirklich eine langfristige salvadorianische Leitung, schreiben Sie an [email protected]; ob sich eine einrichten lässt, hängt von den lokalen Vorschriften ab und ist nicht garantiert. Viele Teams lösen den Fall „wiederholter Login“ stattdessen mit einer US-Leitung, sofern der getestete Dienst sie akzeptiert. Wägen Sie für einen salvadorianischen Rollout beide Wege anhand der Hinweise unter temporäre vs. dedizierte Nummern ab.

Wie sollten +503-Nummern gespeichert und validiert werden?

El Salvador nutzt einen geschlossenen Nummernplan mit 8 Ziffern und ohne Vorwahl-Präfix. Die Nummer, die ein Einheimischer in ein Formular schreibt, besteht aus denselben 8 Ziffern, die international auf +503 folgen; bei der Normalisierung geht es also vor allem darum, Satzzeichen zu entfernen: Einheimische schreiben Mobilnummern oft als zwei Viererblöcke mit Bindestrich.

• Speichern Sie die E.164-Form, +503 gefolgt von acht Ziffern, in einer einzigen Spalte.
• Mobilnummern beginnen in der Regel mit 6 oder 7, Festnetznummern meist mit 2. Ein Validator, der nur diese Anfangsziffern zulässt, fängt die meisten Tippfehler ab.
• Weisen Sie eine zusätzliche führende 0 zurück. Wer andere lateinamerikanische Pläne gewohnt ist, setzt manchmal eine davor, und manche SMS-Plattformen verwerfen die Nachricht dann stillschweigend.

Die SMS-Vorlagen Ihrer App für diesen Markt sind normalerweise spanisch. Zeichen wie á, í oder ó liegen außerhalb des einfachen GSM-Alphabets, sodass eine Vorlage, die sie verwendet, auf UCS-2-Kodierung umschalten und jedes Segment verkürzen kann. Setzen Sie den Code an den Anfang der Nachricht, damit er eine Aufteilung übersteht.

Warum testen Teams Registrierungsabläufe in El Salvador?

Einige Muster kehren immer wieder:

• Starts in Zentralamerika. Ein Produkt, das in Guatemala, Honduras und El Salvador ausgerollt wird, will den Telefonschritt jedes Landes prüfen, bevor die Werbung live geht.
• Auslandssalvadorianer. Viele Salvadorianer leben in den USA und behalten für die Familie eine +503-Nummer, sodass Überweisungs-, Zahlungs- und Messaging-Produkte salvadorianische Nummern sehen, selbst wenn die Adresse der Nutzer amerikanisch ist. Für diesen Ablauf siehe Fintech-Onboarding.
• Lokalisierungs-QA. Spanische Texte, Länderauswahl und Nummernmasken brauchen einen echten salvadorianischen Code, um zu bestätigen, dass die Bildschirme Ende zu Ende funktionieren.
• Preise in US-Dollar. Der US-Dollar ist die offizielle Währung El Salvadors, was den Markt zu einem bequemen Ort macht, um Checkout und Onboarding gemeinsam zu testen.

Wie sieht die Aufrufabfolge der El-Salvador-OTP-API aus?

Alle Anfragen gehen an https://otproute.com/api/v1 mit einem Bearer-Schlüssel mit dem Präfix or_live_, erstellt in der Developer-Konsole (bis zu 10 Schlüssel, 300 Anfragen pro Minute). Die Länder-ID für El Salvador lautet sv.

1. Rufen Sie GET /api/v1/countries und GET /api/v1/services ab und cachen Sie die IDs.
2. Lesen Sie den aktuellen Preis mit GET /api/v1/prices?country=sv&service=<id>; die Antwort sagt Ihnen auch, ob eine Route gerade verfügbar ist.
3. Legen Sie die Bestellung mit POST /api/v1/activations und einem Body wie {"service": "telegram", "country": "sv"} an. Speichern Sie die Aktivierungs-ID und die Nummer.
4. Lassen Sie den salvadorianischen Build Ihrer App seine Verifizierungs-SMS an diese Nummer senden.
5. Warten Sie auf das Ereignis activation.sms_received an Ihrem Endpunkt; ohne Webhook fragen Sie alle paar Sekunden GET /api/v1/activations/{id} ab.
6. Wird der Ablauf abgebrochen, rufen Sie POST /api/v1/activations/{id}/cancel auf, damit das Geld sofort zurückfließt.

Jeder Webhook trägt X-OTPRoute-Signature: t=<unix>,v1=<hex>, einen HMAC-SHA256 aus Zeitstempel, Punkt und Roh-Body mit Ihrem Endpunkt-Secret. Prüfen Sie ihn und verwerfen Sie veraltete Zeitstempel; der Beitrag zum Absichern von OTP-Webhooks führt Sie hindurch. Nicht-Entwickler können dasselbe im Dashboard erledigen: El Salvador wählen, einen Dienst wählen, den Live-Preis bestätigen und zusehen, wie der Code auf der Aktivierungskarte erscheint.

Welche Dienste lassen sich mit einer salvadorianischen Nummer verifizieren?

Der Live-Stand zeigt mehr als 900 Dienste mit Routen für El Salvador. Beliebt sind unter anderem WhatsApp, Facebook, Instagram, TikTok, Uber, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Telegram, Signal, LinkedIn und ChatGPT (OpenAI). Die Verfügbarkeit ändert sich im Tagesverlauf, weshalb der Preis-Endpunkt und nicht eine feste Liste Ihren Test-Runner steuern sollte.

Manche Dienste weisen Nummern ab, die sie als virtuell einstufen. Das liegt außerhalb unserer Kontrolle und ist der Grund für die Erstattungsregel.

Was tun, wenn der salvadorianische Code nie ankommt?

Ein langsamer +503-Code ist noch kein gescheiterter, lassen Sie die Bestellung daher die vollen 20 Minuten offen. Kommt nichts an, läuft die Bestellung ab, activation.expired wird ausgelöst, und der volle Betrag geht automatisch auf Ihr Guthaben zurück. Danach:

• Bestätigen Sie, dass der Dienst für diese Art von Schritt virtuelle Nummern akzeptiert;
• versuchen Sie es später erneut oder wählen Sie eine andere Dienstroute, statt in einer engen Schleife neu zu bestellen;
• prüfen Sie, ob Ihre eigene App die SMS tatsächlich an die exakt zurückgegebene Nummer im E.164-Format gesendet hat.

Weitere, für Zentralamerika geeignete Fehlersuche finden Sie unter Fehlzustellungen von OTPs reduzieren.

Wie wird bei El-Salvador-Bestellungen abgerechnet?

OTP Route nutzt ein vorausbezahltes USD-Guthaben, Pay as you go, ohne Monatsgebühr und ohne Tarifwahl. Aufgeladen wird per Karte oder mit USDT/USDC-Stablecoins, und nach jeder Aufladung oder jedem Nummernkauf landet eine PDF-Rechnung in Ihrem Postfach. Für die Integrationsarbeit kann ein Entwicklungskonto auf Anfrage auf Sandbox umgestellt werden, das simulierte Nummern und Codes liefert, sodass der gesamte Kreislauf läuft, ohne Guthaben zu verbrauchen. Die aktuellen Preise stehen auf der Preisseite. @faq

Häufige Fragen

Kann ich die El-Salvador-Registrierung meiner App ohne lokale SIM-Karte testen?

Ja. Bestellen Sie im OTP Gateway für den getesteten Dienst eine +503-Nummer, lösen Sie die SMS aus und lesen Sie den Code im Dashboard oder über die API aus.

Haben salvadorianische Nummern ein Vorwahl-Präfix wie die 0?

Nein. Nummern in El Salvador haben acht Ziffern ohne Vorwahl-Präfix, die internationale Form ist also einfach +503 plus diese acht Ziffern.

Wie lautet die Länder-ID für El Salvador in der OTP-Route-API?

Verwenden Sie sv in Preisabfragen und im Aktivierungs-Body, zum Beispiel GET /api/v1/prices?country=sv&service=<id>.

Wird mir etwas berechnet, wenn die +503-Nummer nie einen Code erhält?

Nein. Trifft innerhalb des 20-Minuten-Fensters keine SMS ein oder brechen Sie vorher ab, wird der volle Betrag automatisch Ihrem Guthaben gutgeschrieben.

Kann ich eine salvadorianische Nummer für wiederholte Logins behalten?

Nicht als Self-Service-Produkt. Langfristige Dedicated Numbers werden in den USA und Kanada angeboten; für El Salvador können Sie per E-Mail an [email protected] nachfragen, ohne Zusage der Verfügbarkeit.

Ist OTP Route dafür gedacht, viele Konten anzulegen?

Nein. Es dient dem Testen und dem Betrieb Ihrer eigenen legitimen Produkte und Konten, im Rahmen der Bedingungen des jeweiligen Dienstes und der Acceptable Use Policy von OTP Route.

Kann ich den salvadorianischen Ablauf in der CI ausführen, ohne Geld auszugeben?

Ja. Ein Entwicklungskonto kann auf Anfrage auf Sandbox umgestellt werden und liefert simulierte Nummern und Codes, sodass Ihre Pipeline den gesamten API-Pfad durchlaufen kann.

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.