Lista kontrolna przed startem dla numerów weryfikacyjnych z Kajmanów

Lista kontrolna przed startem: co powinno być gotowe, zanim zamówisz numer +1 345?

Przejdź tę listę raz, a pierwsza aktywacja z Kajmanów zwykle przebiegnie bez niespodzianek:

• Konto i bezpieczeństwo. Zarejestruj się adresem e-mail i 6-cyfrowym kodem e-mail (albo logowaniem Google), a potem włącz uwierzytelnianie dwuskładnikowe TOTP dla każdego, kto może wydawać środki z portfela.
• Zasilony portfel. Doładuj przedpłacony portfel w USD kartą lub USDT/USDC. Nie ma pakietu do wyboru ani opłaty miesięcznej.
• Klucz API. Utwórz klucz w konsoli deweloperskiej; zaczyna się od or_live_ i trafia do nagłówka Bearer. Konto może mieć do 10 kluczy.
• Endpoint webhooka. Zarejestruj adres URL i trzymaj jego sekret tam, gdzie Twój handler może go odczytać. Limit to pięć endpointów na konto.
• Skonfigurowane parsowanie numerów. Upewnij się, że Twoja biblioteka numerów rozpoznaje numer kierunkowy 345 jako Kajmany, zamiast domyślnie traktować każdy numer +1 jako amerykański.
• Sandbox, jeśli chcesz próbny przebieg. Poproś wsparcie o przełączenie konta deweloperskiego w tryb sandbox, aby symulowane numery i kody sprawdziły integrację bez dotykania środków z portfela.

Dokumentacja API wylicza każde pole, które zobaczysz w odpowiedziach.

Dlaczego numer z Kajmanów myli kod zakładający, że +1 oznacza Amerykę?

Kajmany należą do Północnoamerykańskiego Planu Numeracyjnego, więc dzielą kod kraju 1 ze Stanami Zjednoczonymi, Kanadą i długą listą terytoriów karaibskich. Kajmańską linię identyfikuje numer kierunkowy 345. Pełny numer to dziesięć cyfr po kodzie kraju, lokalnie zapisywany jako (345) NXX-XXXX, a w E.164 przechowywany jako +1345 i siedem cyfr.

Trzy praktyczne konsekwencje dla inżynierów:

• Wykrywanie regionu musi uwzględniać numer kierunkowy. Formularz rejestracji, który wnioskuje kraj wyłącznie z prefiksu +1, oznaczy klienta z Kajmanów jako Amerykanina i może wybrać złą strefę czasową, walutę lub treść zgody.
• W NANP wiodąca 1 pełni też rolę cyfry międzymiastowej, więc użytkownicy czasem wpisują 1 345... albo samo 345.... Przed zapisem znormalizuj wszystkie trzy formy do ciągu E.164.
• Zapisuj numery bez spacji, myślników i nawiasów, a formatuj je dopiero przy wyświetlaniu.

Językiem urzędowym jest angielski, więc kody dla tego rynku zwykle przychodzą po angielsku. Dokładne brzmienie ustala jednak usługa wysyłająca wiadomość, a nie trasa.

Które usługi mogą kierować kody na numer weryfikacyjny z Kajmanów?

Aktualna migawka dla kraju ky obejmuje obecnie WhatsApp, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Amazon, Airbnb, Uber, Signal, Discord, ChatGPT (OpenAI), Netflix i eBay. Licząc długi ogon, trasa obsługuje ponad 600 usług, a lista zmienia się w ciągu dnia, dlatego dostępność zawsze odczytuje się z API, zamiast wpisywać ją na sztywno.

Zespoły potrzebują numeru +1 345 do testów, bo wyspy są ważnym offshore'owym centrum finansowym i ruchliwym celem turystycznym. Administratorzy funduszy, ubezpieczyciele, platformy podróżnicze i firmy nieruchomościowe wdrażają lokalnych klientów, a ich zespoły produktowe chcą zobaczyć, jak rejestracja działa z perspektywy mieszkańca Kajmanów. Ten wzorzec szerzej opisują notatki o onboardingu fintech.

Krok po kroku: jak przebiega sekwencja wywołań API OTP dla Kajmanów?

Wszystkie wywołania trafiają na https://otproute.com/api/v1 z Twoim kluczem Bearer, w ramach limitu 300 żądań na minutę.

1. Wywołaj raz GET /api/v1/services i zapisz w pamięci podręcznej identyfikatory usług potrzebne w testach.
2. Wywołaj GET /api/v1/prices?country=ky&service=<id>, aby odczytać aktualną cenę i potwierdzić, że para jest teraz dostępna.
3. Wyślij POST /api/v1/activations z treścią w rodzaju {"service": "<id>", "country": "ky"}. Odpowiedź zawiera identyfikator aktywacji i numer +1 345.
4. Wpisz ten numer w testowanej aplikacji i uruchom jej krok SMS.
5. Czekaj na activation.sms_received na webhooku. Najpierw sprawdź nagłówek X-OTPRoute-Signature: oblicz HMAC-SHA256 z <t>.<raw body> sekretem endpointu, porównaj z v1 i odrzucaj nieaktualne znaczniki czasu.
6. Bez webhooka odpytuj GET /api/v1/activations/{id} w umiarkowanych odstępach, aż pojawi się kod albo zamknie się okno.
7. Jeśli test zostanie przerwany, wywołaj POST /api/v1/activations/{id}/cancel, aby blokada wróciła na portfel.

Poradnik o webhookach z HMAC omawia sprawdzanie podpisu linijka po linijce.

Krok po kroku dla kolegów, którzy wolą panel

Pracownicy wsparcia i opiekunowie kont w ogóle nie muszą dotykać API:

1. Otwórz stronę OTP Gateway w panelu.
2. Jako kraj wybierz Kajmany, a potem usługę, którą weryfikujesz.
3. Sprawdź cenę przed zamówieniem i potwierdź.
4. Skopiuj numer do aplikacji, poproś o kod i zostaw stronę aktywacji otwartą; SMS pojawi się tam, gdy dotrze.

20-minutowe okno i zwrot obowiązują dokładnie tak samo jak przez API.

Rozwiązywanie problemów: co, jeśli kod nie dociera na numer +1 345?

Za milczącą aktywację nic nie jest pobierane. Jeśli przed upływem 20 minut nie dotrze żaden SMS albo anulujesz, pełna kwota sama wraca na portfel. Zanim zamówisz ponownie:

• Pozwól oknu dobiec końca. Czas dostawy zależy od usługi i trasy, więc wolny kod niekoniecznie jest nieudany.
• Sprawdź politykę usługi. Niektóre usługi odrzucają numery wirtualne całkowicie, i właśnie na taką sytuację istnieje zwrot.
• Spróbuj później lub zmień trasę. Pula zmienia się w ciągu dnia; druga próba po godzinie albo sąsiedni kraj karaibski może zachować się inaczej.
• Unikaj ciasnych pętli. Skrypt, który co kilka sekund anuluje i zamawia ponownie, zużywa limit żądań i rzadko pomaga.

Poradnik nieudanych dostaw zawiera więcej diagnostyki. Używaj każdego numeru wyłącznie do własnego produktu lub własnych kont firmowych, przestrzegaj warunków każdej usługi i pamiętaj, że obowiązuje Regulamin dopuszczalnego użycia OTP Route.

Czy mogę zachować linię z Kajmanów na dłużej i jak wygląda rozliczanie?

Dla Kajmanów nie istnieje samoobsługowy numer długoterminowy. Wspólny kod kraju +1 tego nie zmienia: numery dedykowane są produktem wyłącznie dla Stanów Zjednoczonych i Kanady, od $1.95/month, z przychodzącymi SMS-ami, wychodzącymi SMS-ami i połączeniami w przeglądarce. Jeśli Twój zespół potrzebuje stałej linii 345, napisz na [email protected]; dostępność zależy od lokalnych przepisów i nie jest obiecana.

Wszystko inne działa z jednego przedpłaconego portfela w USD. Doładowania kartą lub USDT/USDC dostają fakturę PDF e-mailem, a model płatności według zużycia wyjaśnia strona cennika.

Najczęstsze pytania

Czy mogę przetestować rejestrację w mojej aplikacji z Kajmanów bez lokalnej karty SIM?

Tak. Zamów numer +1 345 w OTP Gateway, wpisz go w aplikacji i odczytaj kod w panelu lub przez API. Płacisz od $0.20 za kod i tylko wtedy, gdy kod dotrze.

Jakiego identyfikatora kraju używa API dla Kajmanów?

Identyfikator to ky. Przekaż go jako wartość country przy wywołaniu GET /api/v1/prices lub POST /api/v1/activations.

Jak przechowywać numer z Kajmanów w bazie danych?

Zapisuj go w formie E.164: +1345 i siedmiocyfrowy numer abonencki, bez spacji i znaków interpunkcyjnych. Terytorium wykrywaj po numerze kierunkowym 345, a nie po prefiksie +1.

Czy numer +1 345 liczy się jako amerykański przy numerach dedykowanych?

Nie. Numery dedykowane są sprzedawane tylko dla Stanów Zjednoczonych i Kanady, więc linia z Kajmanów jest dostępna wyłącznie jako aktywacja OTP Gateway na jeden kod.

Co dzieje się z moimi pieniędzmi, jeśli SMS się nie pojawi?

Aktywacja pozostaje otwarta przez 20 minut. Jeśli w tym czasie nie dotrze kod albo wcześniej anulujesz, pełna kwota wraca automatycznie na portfel.

Czy mogę uruchamiać kajmańskie testy OTP w CI bez wydawania środków z portfela?

Poproś wsparcie o przeniesienie konta deweloperskiego do sandboxa. Zwraca on symulowane numery i kody, więc Twój pipeline może przećwiczyć pełny przepływ aktywacji i webhooka bez kosztów.

Ile usług z Kajmanów obsługuje OTP Route?

Ponad 600 w czasie ostatniej migawki. Ponieważ pula zmienia się w ciągu dnia, zapytaj GET /api/v1/services i endpoint cen o bieżącą dostępność.

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.