Jamajskie kody weryfikacyjne SMS: lista kontrolna, kroki i naprawy

Co potwierdzić przed pierwszą jamajską aktywacją?

Jamajka należy do Północnoamerykańskiego Planu Numeracyjnego, więc kilka kontroli wygląda tu inaczej niż w większości krajów:

• Twój walidator akceptuje numery +1, które nie są amerykańskie ani kanadyjskie. Wiele formularzy rejestracji po cichu zakłada, że każdy numer +1 jest amerykański.
• Twój selektor kraju wymienia Jamajkę osobno, a nie traktuje +1 jako jednego regionu.
• Klucz API or_live_ istnieje w konsoli Developer, a endpoint webhooka z sekretem jest wdrożony albo Twoje środowisko testowe jest ustawione na odpytywanie.
• Portfel jest zasilony albo włączono tryb sandbox do próby na sucho.
• Znasz identyfikator usługi z GET /api/v1/services; identyfikator kraju dla Jamajki to jm.

Pomyłka w pierwszych dwóch punktach daje błędy, które wyglądają na problemy z routingiem, a w całości siedzą w Twoim własnym kodzie.

Dlaczego numer jamajski +1 wymaga specjalnego traktowania?

Jamajskie numery używają kierunkowych 876 i nowszego 658, po których następuje siedmiocyfrowy numer abonenta, więc pełna forma E.164 to +1 plus dziesięć cyfr. W kraju przy rozmowach międzymiastowych wybiera się wiodącą 1, którą należy usunąć przed zapisem.

Dla inżynierów ważne jest to, że samo +1 nic nie mówi o kraju. Wykrywanie regionu musi sięgać do numeru kierunkowego, a każda logika wybierająca walutę, strefę czasową lub szablon SMS na podstawie numeru kierunkowego wymaga takiej samej staranności. Zapisuj kanoniczny ciąg E.164, wykryty region trzymaj w osobnym polu i testuj dane wejściowe 876 oraz 658.

Językiem urzędowym jest angielski i SMS-y weryfikacyjne niemal zawsze przychodzą po angielsku, choć w codziennej mowie często używa się jamajskiego patois. Zespoły testują tu pod kątem startów na Karaibach, procesów przekazów pieniężnych i fintech obsługujących diasporę w USA, Wielkiej Brytanii i Kanadzie oraz produktów turystycznych i hotelarskich. Artykuł o routingu krajowym dla OTP opisuje, jak dobierać trasy dla poszczególnych rynków.

Jakie są kroki w API weryfikacji SMS dla Jamajki?

1. Sprawdź aktualne ceny przez GET /api/v1/prices?country=jm&service=<id> względem adresu bazowego https://otproute.com/api/v1.
2. Zamów: POST /api/v1/activations z ciałem {"service": "<id>", "country": "jm"}. Zanotuj identyfikator aktywacji i numer.
3. Wprowadź numer w testowanej aplikacji.
4. Odbierz kod przez zdarzenie activation.sms_received na swoim webhooku albo odpytując GET /api/v1/activations/{id}.
5. Jamajską próbę przerwiesz wcześniej, wysyłając POST /api/v1/activations/{id}/cancel, co zwalnia blokadę środków.

Zanim zareagujesz na jakiekolwiek zdarzenie, oblicz ponownie HMAC-SHA256 z "<t>.<raw body>" przy użyciu sekretu endpointu, porównaj z wartością v1 w X-OTPRoute-Signature i odrzucaj zbyt stare znaczniki czasu. Obsłuż także activation.expired i activation.cancelled, w oparciu o identyfikator aktywacji, aby ponowienia nigdy nie były przetwarzane podwójnie. Przy planowaniu wydajności pamiętaj, że jedno konto może mieć 10 kluczy i 5 endpointów webhooków, z limitem 300 żądań na minutę łącznie.

Które aplikacje mogą odbierać kody na jamajskiej trasie?

Jamajka obejmuje obecnie ponad 900 usług. Do często używanych należą WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Snapchat, Amazon, Uber, Netflix, Airbnb i ChatGPT (OpenAI).

Dostępność poszczególnych usług zmienia się w ciągu dnia, więc na początku każdego przebiegu odczytuj endpoint cen, zamiast na sztywno wpisywać listę.

Jak osoby nietechniczne wykonają tę samą listę kontrolną w panelu?

Załóż konto na /signup z kodem e-mail lub przez Google, włącz TOTP i doładuj portfel. Następnie otwórz OTP Gateway, wybierz usługę, wybierz Jamajkę i potwierdź cenę na żywo. Wklej numer do aplikacji, a kod pojawi się w panelu, gdy tylko nadejdzie SMS. Pracownicy supportu często korzystają z tej ścieżki, by odtworzyć problem klienta z rejestracją na jamajskim numerze.

Rozwiązywanie problemów: jamajski kod jest spóźniony, brakuje go lub został odrzucony

• Odrzucony przy wprowadzaniu? Najpierw sprawdź własny formularz; walidator tylko dla USA to częsty winowajca. Jeśli sama aplikacja zewnętrzna odrzuca numer, może nie akceptować numerów wirtualnych.
• Jeszcze nic? Zostaw aktywację otwartą na pełne 20 minut zamiast anulować i zamawiać od nowa.
• Nadal nic? Spróbuj później albo przez inną trasę usługi. Unikaj bombardowania tego samego zamówienia w pętli.

Gdy przed końcem okna żaden SMS nie dotrze na numer, pełna opłata wraca automatycznie do portfela. Przewodnik ograniczanie nieudanych dostaw OTP zawiera dłuższą listę kontrolną.

Czy linie dedykowane, portfel i sandbox dotyczą Jamajki?

Wspólny numer kierunkowy +1 nie czyni Jamajki częścią produktu dedykowanego. Dedykowane Numery wirtualne sprzedajemy tylko dla Stanów Zjednoczonych i Kanady, od $1.95/month, i nie ma samoobsługowego długoterminowego numeru jamajskiego. Jeśli go potrzebujesz, napisz na [email protected]; decydują lokalne przepisy i nic nie jest obiecane.

Wszystko inne działa tak samo jak gdziekolwiek: przedpłacony portfel w USD, brak opłaty miesięcznej, doładowania kartą lub USDT/USDC oraz faktura PDF e-mailem do każdego. Tryb sandbox, dostępny na prośbę, zwraca symulowane numery i kody do testów integracji. Zobacz /pricing, aby poznać zasady naliczania opłat.

Najczęstsze pytania

Czy mogę przetestować weryfikację telefonu na Jamajce w mojej aplikacji, nie będąc w Kingston?

Tak. Zamów numer +1 876 lub +1 658 dla swojej usługi w OTP Route i odczytaj kod w panelu lub przez API, gdziekolwiek jest Twój zespół.

Jaki identyfikator kraju wysyłać dla Jamajki?

Wyślij jm. Numer kierunkowy to +1, ale API identyfikuje kraj właśnie tym identyfikatorem.

Czy numer jamajski liczy się jako numer amerykański?

Nie. Dzieli kierunkowy +1, ale to osobny kraj z własnymi numerami kierunkowymi, a wiele aplikacji traktuje go jako Jamajkę.

Co dzieje się z moimi pieniędzmi, jeśli jamajski kod nie nadejdzie?

Jeśli w ciągu 20 minut nie dotrze żaden SMS albo anulujesz zamówienie, pełna kwota wraca do portfela.

Czy mogę kupić w OTP Route długoterminowy numer jamajski?

Nie w modelu samoobsługowym. Długoterminowe Numery dedykowane obejmują tylko USA i Kanadę; napisz do supportu, by zapytać o Jamajkę.

Czy da się przetestować przepływ webhooków bez płacenia?

Poproś o tryb sandbox na koncie deweloperskim. Zwraca on symulowane numery i kody, a po stronie handlera pomoże artykuł o przechwytywaniu OTP przez webhooki.

Do jakich zastosowań wolno używać numeru +1 z Jamajki do testów?

Do testowania własnego produktu, automatyzacji QA i prowadzenia legalnych kont firmowych. Karaibską trasę wiążą regulaminy poszczególnych aplikacji oraz Zasady dopuszczalnego użytkowania OTP Route.

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.