Eine Pre-Flight-Checkliste für den Empfang von SMS-Codes aus Curaçao (+599)

Was gehört auf die Checkliste, bevor Sie eine +599-Nummer bestellen?

Inselmärkte belohnen ein wenig Vorbereitung, denn die Verfügbarkeit der Routen ändert sich im Tagesverlauf und ein überhasteter Test kostet Zeit. Haken Sie diese Punkte vor der ersten Anfrage ab:

• Ein API-Schlüssel aus der Developer-Konsole. Schlüssel beginnen mit `or_live_`; ein Konto kann bis zu 10 halten, geben Sie CI und Staging also jeweils einen eigenen.
• Ein aufgeladenes USD-Wallet oder ein auf Anfrage in den Sandbox-Modus versetztes Entwicklungskonto, wenn Sie die Integration nur ausprobieren wollen.
• Die richtigen IDs. Curaçao ist in der API `cw`; die Dienst-ID stammt aus `GET /api/v1/services`.
• Ein Webhook-Endpoint mit gespeichertem Secret oder eine Polling-Schleife mit sinnvollem Intervall. Pro Konto sind bis zu 5 Endpoints erlaubt.
• Eine Speicherregel für +599-Nummern (unten beschrieben), damit Testdaten zu den Produktionsdaten passen.
• Ein Plan für den Leerfall: was Ihr Test tut, wenn das Fenster ohne Code abläuft.

Welche Dienste deckt die Route für Verifizierungsnummern aus Curaçao ab?

Der Live-Stand für Curaçao listet mehr als 400 Dienste. Zu den gängigen gehören Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal, Netflix, Uber und Airbnb. Die Reise- und Messaging-Namen sind diejenigen, zu denen Teams aus Curaçao zuerst greifen, da Gastgewerbe- und Besucherprodukte einen großen Teil der digitalen Registrierungen auf der Insel ausmachen.

Verstehen Sie diese Liste als Ausgangspunkt und nicht als Versprechen. Der Bestand ändert sich im Tagesverlauf, und genau deshalb liefert die API die Verfügbarkeit mit jeder Preisabfrage.

Schritt für Schritt: die Curaçao-OTP-API aufrufen

Jeder Aufruf geht an `https://otproute.com/api/v1` mit Ihrem Bearer-Schlüssel, innerhalb einer Obergrenze von 300 Anfragen pro Minute.

1. Lesen Sie `GET /api/v1/prices?country=cw&service=`, um zu bestätigen, dass die Route offen ist, und den aktuellen Preis dieser Kombination zu sehen.
2. Legen Sie die Bestellung mit `POST /api/v1/activations` an und senden Sie `{"service": "telegram", "country": "cw"}` oder die jeweils benötigte Dienst-ID. Die Antwort enthält eine Aktivierungs-ID und die +599-Nummer.
3. Tragen Sie diese Nummer in den Registrierungs- oder Login-Bildschirm ein, den Sie testen.
4. Warten Sie auf `activation.sms_received` an Ihrem Webhook oder fragen Sie `GET /api/v1/activations/{id}` in ruhigem Intervall ab.
5. Wird der Test abgebrochen, rufen Sie `POST /api/v1/activations/{id}/cancel` auf, damit das Wallet sofort gutgeschrieben wird.

Prüfen Sie, bevor Sie einem Webhook vertrauen, den Header `X-OTPRoute-Signature`: Berechnen Sie HMAC-SHA256 über `"."` mit dem Endpoint-Secret und weisen Sie veraltete Zeitstempel zurück. Die Anleitung zur Webhook-Signatur erklärt es ausführlicher.

Wie speichert und normalisiert man eine +599-Nummer?

Curaçao teilt sich die Landesvorwahl +599 mit Bonaire, Sint Eustatius und Saba, und die Teilnehmernummern von Curaçao folgen dieser Vorwahl mit einer 9. Diese führende 9 gehört zur Nummer und ist keine Vorwahl-Null; ein Normalisierer, der sie entfernt, beschädigt den Datensatz. Speichern Sie den vollständigen E.164-String (`+5999` gefolgt von den restlichen Ziffern) ohne Leerzeichen und formatieren Sie erst bei der Anzeige.

Es lohnt sich außerdem zu prüfen, dass Ihr Telefoneingabe-Widget Curaçao als eigenen Eintrag führt, statt es in eine generische Option „Niederländische Antillen“ einzuordnen, wie es ältere Bibliotheken noch tun.

Zur Sprache: Papiamentu, Niederländisch und Englisch sind alle Amtssprachen, und die meisten globalen Dienste senden Codes auf Englisch oder in der Sprache, die im Konto eingestellt ist. Wenn Ihr Produkt ins Niederländische oder Papiamentu lokalisiert wird, fahren Sie mindestens einen Durchlauf pro Sprache, damit Sie die echte Vorlage sehen und keine Rückfalloption. Teams testen hier üblicherweise bei einem Start in der niederländischen Karibik, für Besucher, die aus dem Ausland buchen, oder für den regionalen Betrieb von der Insel aus.

Wie sieht der Weg im Dashboard für Leute aus, die keinen Code schreiben?

Support-Mitarbeiter und Produktmanager können dasselbe ganz ohne Skripte tun:

1. Erstellen Sie ein Konto mit E-Mail und einem 6-stelligen Code oder per Google-Anmeldung und aktivieren Sie die Zwei-Faktor-Authentifizierung per TOTP.
2. Laden Sie das Wallet auf.
3. Öffnen Sie das OTP Gateway, wählen Sie den Dienst und dann Curaçao; der Preis erscheint vor der Bestätigung.
4. Kopieren Sie die +599-Nummer in die App und beobachten Sie die Aktivierungskarte, bis der Code erscheint.

Es gelten dasselbe 20-Minuten-Fenster und dieselbe Erstattungsregel wie bei der API.

Fehlerbehebung: Der Code aus Curaçao ist nie erschienen

Eine stumme Aktivierung kommt hin und wieder vor und kostet nichts, denn der Betrag geht an das Wallet zurück, wenn das Fenster schließt oder Sie stornieren.

• Lassen Sie das Fenster laufen. Manche Dienste senden langsam erneut; ein Abbruch in Minute zwei wirft einen Code weg, der noch ankommen könnte.
• Prüfen Sie die Haltung des Zieldienstes zu virtuellen Nummern. Manche lehnen sie ab, weshalb es die Erstattung gibt.
• Versuchen Sie es später oder über eine andere Länder-Route, wenn der Test nicht gerade von einer Nummer aus Curaçao abhängt.
• Vermeiden Sie Neubestellungen in einer engen Schleife. Gehen Sie zwischen den Versuchen in Abständen vor, damit Sie nicht mehrere parallele Aktivierungen für einen Test stapeln.

Die Lösungsseite zum QA-Testing zeigt, wie Teams solche Wiederholungen in automatisierte Suiten einbauen.

Langzeit-Leitungen, Wallet und Abrechnung für Projekte in Curaçao

Für Curaçao gibt es keine Self-Service-Nummer für den Dauerbetrieb. Wenn Sie eine Leitung brauchen, die Sie über Monate behalten, schreiben Sie an [email protected], und das Team prüft, was die lokalen Vorschriften zulassen; zugesagt wird nichts. Dedizierte Leitungen sind ein Produkt für die USA und Kanada ab $1.95/Monat und auf der Seite Virtuelle Nummern beschrieben.

Aktivierungen für Curaçao werden von einem einzigen vorausbezahlten USD-Wallet abgebucht, ohne monatliche Gebühr und ohne Tarifwahl. Zum Aufladen funktionieren Kartenzahlung und USDT/USDC, und jede Aufladung erzeugt eine per E-Mail zugesandte PDF-Rechnung für die Bücher Ihres Curaçao-Projekts. Aktuelle Preise stehen auf der Preisseite. Nutzen Sie OTP Route nur für Ihre eigenen Produkte und legitimen Konten, halten Sie die Bedingungen des jeweiligen Dienstes ein und beachten Sie, dass die Acceptable Use Policy von OTP Route gilt.

Häufige Fragen

Kann ich einen Registrierungsablauf für Curaçao testen, ohne eine lokale SIM zu kaufen?

Ja. Bestellen Sie im OTP Gateway eine +599-Nummer für den getesteten Dienst und lesen Sie den Code im Dashboard oder über die API, ohne SIM oder Handy auf der Insel.

Welche Länder-ID verwendet OTP Route für Curaçao?

Curaçao ist `cw`. Kombinieren Sie `cw` bei jeder Preisabfrage und Bestellung mit der Dienst-ID aus `GET /api/v1/services`.

Ist die 9 nach +599 eine Vorwahl-Null, die ich weglassen soll?

Nein. Für Curaçao gehört die 9 zur Teilnehmernummer, behalten Sie sie also im gespeicherten E.164-Wert.

Werde ich belastet, wenn eine Aktivierung für Curaçao ohne Code abläuft?

Nein. Trifft innerhalb von 20 Minuten keine SMS ein oder stornieren Sie vorher, geht der volle Betrag automatisch an Ihr Wallet zurück.

Kann ich eine Nummer aus Curaçao für wiederholte Logins im nächsten Monat behalten?

Nicht im Self-Service. Langfristige dedizierte Nummern werden nur für die USA und Kanada verkauft; für Curaçao können Sie dem Support schreiben, ohne Zusage zur Verfügbarkeit.

Wie kann ich die Integration aufbauen, bevor ich Wallet-Guthaben ausgebe?

Beantragen Sie über den Support den Sandbox-Modus für ein Entwicklungskonto. Er liefert simulierte Nummern und Codes, sodass der gesamte Pfad aus API und Webhook von Anfang bis Ende durchgespielt werden 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.