Lista kontrolna przed odbieraniem kodów SMS z Curaçao (+599)

Co powinno znaleźć się na liście kontrolnej przed zamówieniem numeru +599?

Rynki wyspiarskie nagradzają odrobinę przygotowania, bo dostępność tras zmienia się w ciągu dnia, a pośpieszny test marnuje czas. Odhacz te punkty przed pierwszym żądaniem:

• Klucz API z konsoli deweloperskiej. Klucze zaczynają się od or_live_; konto może mieć ich do 10, więc daj CI i stagingowi osobne.
• Zasilony portfel w USD albo konto deweloperskie przełączone na prośbę w tryb sandbox, jeśli chcesz tylko przećwiczyć integrację.
• Właściwe identyfikatory. Curaçao to w API cw; identyfikator usługi pochodzi z GET /api/v1/services.
• Endpoint webhooka z zapisanym sekretem albo pętla odpytywania z rozsądnym interwałem. Na konto dozwolonych jest do 5 endpointów.
• Reguła zapisu numerów +599 (omówiona niżej), aby dane testowe odpowiadały produkcyjnym.
• Plan na pusty przypadek: co robi Twój test, gdy okno wygaśnie bez kodu.

Jakie usługi obejmuje trasa numeru weryfikacyjnego dla Curaçao?

Aktualny zrzut dla Curaçao wymienia ponad 400 usług. Popularne to Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal, Netflix, Uber i Airbnb. Nazwy z branży turystycznej i komunikatory to te, po które zespoły z Curaçao sięgają najczęściej, bo produkty hotelarskie i skierowane do odwiedzających generują dużą część cyfrowych rejestracji na wyspie.

Traktuj tę listę jako punkt wyjścia, a nie obietnicę. Zasoby zmieniają się w ciągu dnia, i właśnie dlatego API zwraca dostępność przy każdym zapytaniu o cenę.

Krok po kroku: wywołania API OTP dla Curaçao

Każde wywołanie trafia na https://otproute.com/api/v1 z Twoim kluczem Bearer, w limicie 300 żądań na minutę.

1. Odczytaj GET /api/v1/prices?country=cw&service=<id>, aby potwierdzić, że trasa jest otwarta, i zobaczyć bieżącą cenę tej pary.
2. Utwórz zamówienie przez POST /api/v1/activations, wysyłając {"service": "telegram", "country": "cw"} lub inny potrzebny identyfikator usługi. Odpowiedź zawiera identyfikator aktywacji i numer +599.
3. Wpisz ten numer na ekranie rejestracji lub logowania, który testujesz.
4. Poczekaj na activation.sms_received w webhooku albo odpytuj GET /api/v1/activations/{id} w spokojnych odstępach.
5. Jeśli test zostanie porzucony, wywołaj POST /api/v1/activations/{id}/cancel, aby środki od razu wróciły do portfela.

Zanim zaufasz jakiemukolwiek webhookowi, sprawdź nagłówek X-OTPRoute-Signature: oblicz HMAC-SHA256 z "<t>.<raw body>" przy użyciu sekretu endpointu i odrzucaj przeterminowane znaczniki czasu. Przewodnik po podpisywaniu webhooków omawia to głębiej.

Jak przechowywać i normalizować numer +599?

Curaçao dzieli kod kraju +599 z Bonaire, Sint Eustatius i Sabą, a numery abonentów z Curaçao następują po tym kodzie z cyfrą 9. To początkowe 9 jest częścią numeru, a nie prefiksem krajowym, więc normalizator, który je usuwa, zepsuje rekord. Zapisuj pełny ciąg E.164 (+5999 i pozostałe cyfry) bez spacji, a formatowanie dodawaj dopiero przy wyświetlaniu.

Warto też sprawdzić, czy widżet pola telefonu wymienia Curaçao jako osobną pozycję, a nie wrzuca go do ogólnej opcji Antyli Holenderskich, co starsze biblioteki wciąż robią.

Językowo: papiamento, niderlandzki i angielski są urzędowe, a większość globalnych usług wysyła kody po angielsku lub według języka ustawionego na koncie. Jeśli Twój produkt jest zlokalizowany na niderlandzki lub papiamento, wykonaj co najmniej jeden przebieg dla każdego języka, aby zobaczyć prawdziwy szablon, a nie zapasowy. Zespoły testują tu zwykle przy wejściu na rynek Karaibów Holenderskich, obsłudze gości rezerwujących z zagranicy albo prowadzeniu regionalnych operacji z wyspy.

Jak wygląda ścieżka w panelu dla osób, które nie piszą kodu?

Pracownicy wsparcia i menedżerowie produktu mogą zrobić to samo bez żadnych skryptów:

1. Załóż konto przez e-mail i 6-cyfrowy kod albo logowanie Google i włącz dwuskładnikowe uwierzytelnianie TOTP.
2. Zasil portfel.
3. Otwórz OTP Gateway, wybierz usługę, a potem Curaçao; cena pojawia się przed potwierdzeniem.
4. Skopiuj numer +599 do aplikacji i obserwuj kartę aktywacji, aż pojawi się kod.

Obowiązuje to samo 20-minutowe okno i ta sama zasada zwrotu co w API.

Rozwiązywanie problemów: kod z Curaçao się nie pojawił

Cicha aktywacja zdarza się od czasu do czasu i nic nie kosztuje, bo kwota wraca do portfela, gdy okno się zamyka albo anulujesz.

• Pozwól oknu dobiec do końca. Niektóre usługi wysyłają ponownie powoli; anulowanie w drugiej minucie wyrzuca kod, który mógłby jeszcze przyjść.
• Sprawdź stosunek docelowej usługi do numerów wirtualnych. Niektóre je odrzucają, i właśnie dlatego istnieje zwrot.
• Spróbuj później albo przez inną trasę kraju, jeśli test nie zależy konkretnie od numeru z Curaçao.
• Unikaj ponownych zamówień w ciasnej pętli. Rób przerwy między próbami, aby nie piętrzyć równoległych aktywacji dla jednego testu.

Strona rozwiązania do testów QA pokazuje, jak zespoły wbudowują takie ponowienia w zautomatyzowane zestawy testów.

Linie długoterminowe, portfel i rozliczenia dla projektów z Curaçao

Dla Curaçao nie ma samoobsługowego numeru długoterminowego. Jeśli potrzebujesz linii na miesiące, napisz na [email protected], a zespół sprawdzi, na co pozwalają lokalne przepisy; nic nie jest obiecane. Linie dedykowane to produkt dla USA i Kanady, od $1.95/miesiąc, opisany na stronie numerów wirtualnych.

Aktywacje dla Curaçao korzystają z jednego przedpłaconego portfela w USD, bez opłaty miesięcznej i bez wyboru planu. Do zasilania działają płatności kartą oraz USDT/USDC, a każde doładowanie generuje fakturę w PDF wysyłaną e-mailem do księgowości Twojego projektu z Curaçao. Aktualne stawki są na stronie cennika. Używaj OTP Route tylko do własnych produktów i legalnych kont, przestrzegaj regulaminów usług i pamiętaj, że obowiązują Zasady dopuszczalnego użytkowania OTP Route.

Najczęstsze pytania

Czy mogę przetestować rejestrację z Curaçao bez kupowania lokalnej karty SIM?

Tak. Zamów numer +599 w OTP Gateway dla testowanej usługi i odczytaj kod w panelu lub przez API, bez karty SIM i telefonu na wyspie.

Jakiego identyfikatora kraju używa OTP Route dla Curaçao?

Curaçao to cw. Łącz cw z identyfikatorem usługi z GET /api/v1/services w każdym sprawdzeniu ceny i zamówieniu.

Czy 9 po +599 to prefiks krajowy, który mam pominąć?

Nie. W Curaçao 9 jest częścią numeru abonenta, więc zachowaj je w zapisanej wartości E.164.

Czy zapłacę, gdy aktywacja dla Curaçao wygaśnie bez kodu?

Nie. Jeśli SMS nie dotrze w ciągu 20 minut albo wcześniej anulujesz, pełna kwota wraca automatycznie do portfela.

Czy mogę zachować numer z Curaçao do powtórnych logowań w przyszłym miesiącu?

Nie w trybie samoobsługowym. Długoterminowe numery dedykowane są sprzedawane tylko dla USA i Kanady; w sprawie Curaçao możesz napisać do wsparcia i zapytać, bez żadnej obietnicy dostępności.

Jak podłączyć integrację, zanim wydam środki z portfela?

Poproś wsparcie o tryb sandbox dla konta deweloperskiego. Zwraca symulowane numery i kody, więc pełną ścieżkę API i webhooków można przećwiczyć od początku do końca.

Nazwy usług są znakami towarowymi ich właścicieli. OTP Route nie jest z nimi powiązany. Korzystaj z numerów zgodnie z prawem oraz przestrzegaj regulaminów poszczególnych usług i naszej Polityki akceptowalnego użytkowania.