Der Entwicklerweg zu Schweizer Verifizierungscodes (+41)

Welche Requests liefern per API einen Schweizer Code?

Die Schweiz-OTP-API ist dieselbe schlanke Schnittstelle wie für jedes andere Land, mit ch als Länder-ID. Authentifizieren Sie sich mit einem Bearer-Schlüssel (Präfix or_live_), den Sie in der Developer-Konsole erstellen; ein Konto kann bis zu 10 Schlüssel besitzen.

1. Ermitteln Sie die IDs über GET /api/v1/services und GET /api/v1/countries und halten Sie sie zwischen den Läufen im Cache.
2. Prüfen Sie GET /api/v1/prices?country=ch&service=<id>. Die Antwort enthält den aktuellen Preis und ob gerade eine Route offen ist.
3. Senden Sie POST /api/v1/activations mit {"service": "whatsapp", "country": "ch"} oder dem Dienst, den Ihr Test abdeckt. Behalten Sie die zurückgegebene Aktivierungs-ID.
4. Tragen Sie die +41-Nummer in das Telefonfeld Ihres eigenen Produkts ein.
5. Lesen Sie das Ergebnis über GET /api/v1/activations/{id} oder per Webhook aus; mit POST /api/v1/activations/{id}/cancel brechen Sie sauber ab.

GET /api/v1/balance gehört in den Setup-Schritt Ihrer Test-Suite. Das Limit liegt bei 300 Requests pro Minute und Konto, was mehrere parallele Jobs mit entspanntem Polling-Intervall problemlos abdeckt. Die Endpunkt-Referenz finden Sie in der Dokumentation.

Polling oder Webhooks für +41-Aktivierungen?

Polling hält ein schnelles Skript einfach. Webhooks sind überlegen, sobald Tests parallel laufen, weil nichts im Leerlauf warten muss, während eine SMS Richtung Zürich unterwegs ist.

OTP Route erlaubt bis zu fünf registrierte Endpunkte; abonnieren Sie auf jedem activation.sms_received, activation.expired und activation.cancelled. Prüfen Sie jede Zustellung, bevor Sie ihr vertrauen: Nehmen Sie die Teile t und v1 aus X-OTPRoute-Signature, berechnen Sie HMAC-SHA256 über "<t>.<raw body>" mit dem Endpunkt-Secret, vergleichen Sie in konstanter Zeit und weisen Sie Zeitstempel außerhalb einer kurzen Toleranz zurück. Verarbeiten Sie anhand der Aktivierungs-ID, damit eine wiederholte Zustellung folgenlos bleibt.

Eine ausführlichere Behandlung der Signaturprüfung finden Sie unter OTP-Webhooks mit HMAC absichern.

Wie sollte eine Schweizer Nummer in Ihrer Datenbank aussehen?

National beginnen Schweizer Nummern mit der Vorwahl 0, etwa ein Mobilanschluss in der Schreibweise 079 123 45 67. International entfällt diese Null: Die E.164-Form lautet +41 79 123 45 67, mit neun Ziffern nach der Landesvorwahl. Mobilnummern liegen im Bereich 07x. Speichern Sie den kanonischen String +41… und formatieren Sie nur für die Anzeige, sonst scheitern Deduplizierung und Abfragen, wenn eine Schreibweise 079 und eine andere +4179 verwendet.

Die zweite Schweizer Besonderheit ist die Sprache. Da Deutsch, Französisch, Italienisch und Rätoromanisch Landessprachen sind, kann eine Verifizierungs-SMS je nach Sprachlogik des Absenders in einer der ersten drei Sprachen eintreffen, und viele Apps greifen einfach auf Englisch zurück. Wenn Ihr Produkt regional lokalisiert, ist ein echter +41-Code eine günstige Möglichkeit zu bestätigen, dass die richtige Vorlage ausgelöst wird.

Teams testen hier vor dem Start eines Fintech- oder E-Commerce-Produkts im Schweizer Markt, bei der Betreuung von Mitarbeitenden, die Geschäftskonten aus Genf oder Basel verwalten, oder bei der Prüfung grenzüberschreitender Abläufe, die auch Liechtenstein berühren, das eine eigene Vorwahl (+423) hat.

Dienste, die Sie mit einer Schweizer Verifizierungsnummer prüfen können

Die aktuelle Momentaufnahme für ch nennt unter anderem Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, WhatsApp, Telegram, Signal, Uber, Airbnb, Amazon, eBay, Netflix, Discord, ChatGPT (OpenAI) und Claude. Insgesamt bietet die Schweiz im OTP Gateway mehr als 1.700 Dienste.

Da sich die Verfügbarkeit im Tagesverlauf ändert, betrachten Sie diese Liste als Ausgangspunkt und fragen Sie zur Laufzeit die Live-Daten ab. Ein Test-Harness, das zuerst die Preise prüft und einen Test als übersprungen markiert, wenn die Route geschlossen ist, liefert deutlich sauberere Berichte als eines, das blind wiederholt.

Fehlersuche bei einer Schweizer Aktivierung, die leer bleibt

Wenn eine +41-Nummer nichts empfängt, gehen Sie diese Punkte durch, bevor Sie Ihren Code anfassen:

• Geben Sie dem vollen 20-Minuten-Fenster eine Chance; manche Plattformen stellen ausgehende Nachrichten in eine Warteschlange.
• Prüfen Sie, ob der Dienst virtuelle Nummern ablehnt. Mehrere tun das, und genau dafür gibt es die automatische Erstattung.
• Versuchen Sie es nach einer Pause erneut oder nutzen Sie eine andere Dienstroute, statt in enger Schleife neu zu bestellen.
• Brechen Sie nicht benötigte Aktivierungen ab, damit das Geld sofort zurückfließt.

Der Beitrag zum Länder-Routing für OTP erklärt, warum sich dieselbe App von Länderroute zu Länderroute unterschiedlich verhalten kann.

Gibt es eine langfristige Schweizer Nummer?

Nicht als Self-Service-Produkt. Für die Schweiz bietet OTP Route ausschließlich Einmalnummern über das OTP Gateway an.

Dedicated Virtual Numbers, die Sie behalten, solange sie verlängert werden, gibt es nur für die Vereinigten Staaten und Kanada, ab $1.95/month. Wenn Sie ausdrücklich eine dauerhafte Schweizer Leitung benötigen, schreiben Sie an [email protected] und beschreiben Sie den Anwendungsfall; die Antwort hängt von den lokalen Vorschriften ab und kann nicht im Voraus zugesagt werden.

Wallet, Rechnungen und Sandbox für Schweizer OTP-Routing

Sie zahlen nutzungsbasiert aus einem einzigen vorausbezahlten USD-Wallet. Es gibt keine Monatsgebühr und keinen Tarif zur Auswahl. Laden Sie es per Karte oder mit USDT/USDC auf; für jede Aufladung wird eine PDF-Rechnung per E-Mail zugestellt, was die Buchhaltung für Schweizer Unternehmen übersichtlich hält, die in Franken abrechnen.

Für Integrationsarbeiten können Sie den Sandbox-Modus für ein Entwicklungskonto anfordern. Er liefert simulierte Nummern und Codes, sodass der gesamte Ablauf der SMS-Verifizierungs-API ohne Verbrauch von Wallet-Guthaben getestet werden kann. Nutzen Sie echte Aktivierungen nur für Ihre eigenen Produkte und Konten, im Rahmen der Bedingungen des jeweiligen Dienstes und der Acceptable Use Policy von OTP Route. Die Seite zur QA-Test-Lösung zeigt, wie Teams das in ihre Release-Prüfungen einbauen.

Häufige Fragen

Welche Länder-ID verwendet die API für die Schweiz?

Die Schweiz ist ch. Schweizer Requests tragen diesen zweistelligen Wert überall dort, wo ein Land erwartet wird, auch im Body der Aktivierung.

Kann ich einen Schweizer Login-Ablauf prüfen, ohne eine Schweizer SIM zu besitzen?

Ja. Eine +41-Nummer zum Testen aus dem OTP Gateway empfängt den Code, den Sie dann im Dashboard oder über die API auslesen.

Sollte ich die 0 beim Speichern einer Schweizer Mobilnummer behalten?

Nein. Die 0 ist eine nationale Vorwahl; speichern Sie die E.164-Form, die mit +41 beginnt und von neun Ziffern gefolgt wird.

In welcher Sprache kommt eine Schweizer Verifizierungs-SMS an?

Das hängt vom Absender ab: Deutsch, Französisch, Italienisch oder Englisch sind alle üblich. Extrahieren Sie den Code mit einem Ziffernmuster statt mit festem Wortlaut.

Was kostet ein SMS-OTP aus der Schweiz?

Ab $0.20 per code; den genauen Preis pro Dienst liefert GET /api/v1/prices, bevor Sie bestellen.

Was passiert mit meinem Geld, wenn kein Code ankommt?

Es geht automatisch auf Ihr Wallet zurück, wenn das Fenster abläuft oder Sie die Aktivierung abbrechen.

Deckt die Schweizer Route auch Liechtenstein ab?

Nein, Liechtenstein hat eine eigene Landesvorwahl (+423) und eine eigene Seite in der Länderliste, bestellen Sie es also separat.

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.