Eine Pre-Flight-Checkliste für Verifizierungsnummern der Kaimaninseln

Pre-Flight-Checkliste: Was sollte bereitstehen, bevor Sie eine +1-345-Nummer bestellen?

Gehen Sie diese Liste einmal durch, und die erste Aktivierung für die Kaimaninseln verläuft in der Regel unspektakulär:

• Konto und Sicherheit. Registrieren Sie sich mit einer E-Mail-Adresse und einem 6-stelligen E-Mail-Code (oder per Google-Anmeldung) und aktivieren Sie die TOTP-Zwei-Faktor-Authentifizierung für alle, die vom Guthaben ausgeben dürfen.
• Aufgeladenes Guthaben. Laden Sie das vorausbezahlte USD-Guthaben per Karte oder mit USDT/USDC auf. Es gibt keinen Tarif zu wählen und keine monatliche Gebühr.
• API-Schlüssel. Erstellen Sie in der Developer-Konsole einen Schlüssel; er beginnt mit or_live_ und gehört in einen Bearer-Header. Ein Konto kann bis zu 10 Schlüssel halten.
• Webhook-Endpunkt. Registrieren Sie eine URL und legen Sie ihr Secret dort ab, wo Ihr Handler es lesen kann. Fünf Endpunkte pro Konto sind die Obergrenze.
• Telefonnummern-Parsing konfiguriert. Stellen Sie sicher, dass Ihre Nummernbibliothek die Vorwahl 345 den Kaimaninseln zuordnet, statt jede +1-Nummer standardmäßig den Vereinigten Staaten zuzuschreiben.
• Sandbox für einen Probelauf. Bitten Sie den Support, ein Entwicklungskonto in den Sandbox-Modus zu versetzen, damit simulierte Nummern und Codes Ihre Integration üben, ohne das Guthaben anzutasten.

Die API-Referenz listet jedes Feld auf, das Sie in Antworten sehen werden.

Warum stolpert Code über eine Nummer der Kaimaninseln, wenn er +1 mit Amerika gleichsetzt?

Die Kaimaninseln gehören zum nordamerikanischen Nummerierungsplan und teilen sich damit die Landesvorwahl 1 mit den USA, Kanada und einer langen Reihe karibischer Gebiete. Eine Leitung der Kaimaninseln erkennt man an der Vorwahl 345. Eine vollständige Nummer hat zehn Ziffern nach der Landesvorwahl, wird lokal als (345) NXX-XXXX geschrieben und im E.164-Format als +1345 gefolgt von sieben Ziffern gespeichert.

Drei praktische Folgen für Entwickler:

• Die Regionserkennung muss die Vorwahl betrachten. Ein Registrierungsformular, das das Land allein aus dem Präfix +1 ableitet, stuft einen Kunden von den Kaimaninseln als Amerikaner ein und wählt womöglich die falsche Zeitzone, Währung oder Einwilligungstexte.
• Im NANP dient die führende 1 zugleich als Fernverkehrs-Trunkziffer, daher tippen Nutzer manchmal 1 345... oder nur 345.... Normalisieren Sie alle drei Varianten vor dem Speichern auf den E.164-String.
• Speichern Sie Nummern ohne Leerzeichen, Bindestriche oder Klammern und formatieren Sie sie erst bei der Anzeige.

Englisch ist Amtssprache, daher kommen Codes für diesen Markt meist auf Englisch an. Den genauen Wortlaut legt jedoch der Dienst fest, der die Nachricht sendet, nicht die Route.

Welche Dienste können Codes an eine Verifizierungsnummer der Kaimaninseln leiten?

Die Live-Momentaufnahme für das Land ky umfasst derzeit WhatsApp, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Amazon, Airbnb, Uber, Signal, Discord, ChatGPT (OpenAI), Netflix und eBay. Zählt man den langen Schwanz mit, deckt die Route mehr als 600 Dienste ab, und die Liste ändert sich im Tagesverlauf, weshalb die Verfügbarkeit stets aus der API gelesen und nie fest codiert wird.

Teams brauchen zum Testen meist eine +1-345-Nummer, weil die Inseln ein bedeutendes Offshore-Finanzzentrum und ein belebtes Urlaubsziel sind. Fondsverwalter, Versicherer, Reiseplattformen und Immobilienunternehmen onboarden lokale Kunden, und ihre Produktteams wollen sehen, wie sich der Registrierungsablauf aus Sicht eines Einwohners der Kaimaninseln verhält. Die Hinweise zum Fintech-Onboarding behandeln dieses Muster ausführlicher.

Schritt für Schritt: Wie läuft die Aufrufabfolge der Kaimaninseln-OTP-API ab?

Alle Aufrufe gehen an https://otproute.com/api/v1 mit Ihrem Bearer-Schlüssel, innerhalb eines Limits von 300 Anfragen pro Minute.

1. Rufen Sie einmal GET /api/v1/services ab und cachen Sie die Service-IDs, die Ihre Testsuite braucht.
2. Rufen Sie GET /api/v1/prices?country=ky&service=<id> auf, um den Live-Preis zu lesen und zu bestätigen, dass die Kombination gerade verfügbar ist.
3. Senden Sie POST /api/v1/activations mit einem Body wie {"service": "<id>", "country": "ky"}. Die Antwort enthält die Aktivierungs-ID und die +1-345-Nummer.
4. Geben Sie die Nummer in der zu testenden App ein und lösen Sie deren SMS-Schritt aus.
5. Warten Sie auf activation.sms_received an Ihrem Webhook. Prüfen Sie zuerst den Header X-OTPRoute-Signature: Berechnen Sie HMAC-SHA256 über <t>.<raw body> mit dem Endpunkt-Secret, vergleichen Sie es mit v1 und weisen Sie veraltete Zeitstempel zurück.
6. Ohne Webhook fragen Sie GET /api/v1/activations/{id} in mäßigem Abstand ab, bis der Code erscheint oder das Fenster endet.
7. Bricht der Test ab, rufen Sie POST /api/v1/activations/{id}/cancel auf, damit die Reservierung ans Guthaben zurückgeht.

Die HMAC-Webhook-Anleitung führt Zeile für Zeile durch die Signaturprüfung.

Schritt für Schritt für Kollegen, die das Dashboard bevorzugen

Support-Mitarbeitende und Account Manager müssen die API gar nicht anfassen:

1. Öffnen Sie im Dashboard die Seite des OTP Gateway.
2. Wählen Sie die Kaimaninseln als Land und dann den Dienst, den Sie verifizieren.
3. Prüfen Sie den angezeigten Preis vor der Bestellung und bestätigen Sie.
4. Kopieren Sie die Nummer in die App, fordern Sie den Code an und lassen Sie die Aktivierungsseite offen; die SMS erscheint dort, sobald sie ankommt.

Das 20-Minuten-Fenster und die Erstattung gelten genau wie über die API.

Fehlersuche: Was tun, wenn kein Code die +1-345-Nummer erreicht?

Für eine stumme Aktivierung wird nichts berechnet. Kommt vor Ablauf der 20 Minuten keine SMS an oder brechen Sie ab, geht der volle Betrag von selbst ans Guthaben zurück. Bevor Sie erneut bestellen:

• Lassen Sie das Fenster laufen. Die Zustellzeit hängt vom Dienst und von der Route ab, ein langsamer Code ist also nicht zwingend ein gescheiterter.
• Prüfen Sie die Richtlinie des Dienstes. Manche Dienste lehnen virtuelle Nummern rundweg ab, genau dafür gibt es die Erstattung.
• Versuchen Sie es später oder wechseln Sie die Route. Der Bestand ändert sich im Tagesverlauf; ein zweiter Versuch eine Stunde später oder ein benachbartes karibisches Land kann sich anders verhalten.
• Vermeiden Sie enge Schleifen. Ein Skript, das alle paar Sekunden abbricht und neu bestellt, verbraucht Ihr Ratenlimit und hilft selten.

Das Playbook zu fehlgeschlagenen Zustellungen enthält weitere Diagnosen. Nutzen Sie jede Nummer nur für Ihr eigenes Produkt oder Ihre eigenen Geschäftskonten, beachten Sie die Bedingungen jedes Dienstes und denken Sie daran, dass die Acceptable Use Policy von OTP Route gilt.

Kann ich eine Leitung der Kaimaninseln langfristig behalten, und wie läuft die Abrechnung?

Eine selbst buchbare langfristige Nummer für die Kaimaninseln gibt es nicht. Die gemeinsame Landesvorwahl +1 ändert daran nichts: Dedicated Numbers sind ein reines Produkt für die Vereinigten Staaten und Kanada, ab $1.95/Monat, mit eingehenden SMS, ausgehenden SMS und Telefonie im Browser. Braucht Ihr Team eine dauerhafte 345-Leitung, schreiben Sie an [email protected]; die Verfügbarkeit hängt von den lokalen Vorschriften ab und wird nicht zugesagt.

Alles Übrige läuft über ein vorausbezahltes USD-Guthaben. Aufladungen per Karte oder USDT/USDC erzeugen jeweils eine PDF-Rechnung per E-Mail, und die Preisseite erläutert das Pay-as-you-go-Modell.

Häufige Fragen

Kann ich den Registrierungsablauf meiner App für die Kaimaninseln ohne lokale SIM-Karte testen?

Ja. Bestellen Sie über das OTP Gateway eine +1-345-Nummer, geben Sie sie in Ihrer App ein und lesen Sie den Code im Dashboard oder über die API. Sie zahlen ab $0.20 pro Code und nur, wenn der Code ankommt.

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

Die ID lautet ky. Übergeben Sie sie als Wert von country, wenn Sie GET /api/v1/prices oder POST /api/v1/activations aufrufen.

Wie sollte ich eine Telefonnummer der Kaimaninseln in meiner Datenbank speichern?

Speichern Sie sie im E.164-Format: +1345 gefolgt von der siebenstelligen Teilnehmernummer, ohne Leerzeichen oder Satzzeichen. Erkennen Sie das Gebiet an der Vorwahl 345, nicht am Präfix +1.

Zählt eine +1-345-Nummer bei Dedicated Numbers als US-Nummer?

Nein. Dedicated Numbers werden nur für die Vereinigten Staaten und Kanada verkauft, eine Leitung der Kaimaninseln ist also nur als Einzelcode-Aktivierung im OTP Gateway verfügbar.

Was passiert mit meinem Geld, wenn die SMS nie erscheint?

Die Aktivierung bleibt 20 Minuten offen. Kommt in dieser Zeit kein Code an oder brechen Sie vorher ab, wird der volle Betrag automatisch Ihrem Guthaben gutgeschrieben.

Kann ich OTP-Tests für die Kaimaninseln in der CI ausführen, ohne Guthaben auszugeben?

Bitten Sie den Support, ein Entwicklungskonto auf Sandbox umzustellen. Es liefert simulierte Nummern und Codes, sodass Ihre Pipeline den gesamten Aktivierungs- und Webhook-Ablauf kostenlos durchspielen kann.

Wie viele Dienste deckt OTP Route für die Kaimaninseln ab?

Mehr als 600 zum Zeitpunkt der letzten Momentaufnahme. Da sich der Bestand im Tagesverlauf ändert, fragen Sie GET /api/v1/services und den Preis-Endpunkt nach der Live-Verfügbarkeit ab.

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.