Lista kontrolna odbioru kodów weryfikacyjnych z Saint-Barthélemy (+590)

Lista kontrolna przed zamówieniem numeru +590

Saint-Barthélemy to jedna z mniejszych tras w OTP Route, więc odrobina przygotowania oszczędza zmarnowanych prób:

• Potwierdź, że usługa jest dziś na liście. Wywołaj GET /api/v1/countries i GET /api/v1/services albo otwórz panel; identyfikator kraju to bl.
• Sprawdź cenę. GET /api/v1/prices?country=bl&service=<id> zwraca aktualną kwotę dla tej pary.
• Zasil portfel i w zadaniach automatycznych najpierw sprawdź GET /api/v1/balance.
• Przygotuj pole telefonu, aby akceptowało numer +590 z dziewięcioma cyframi po kodzie kraju.
• Poznaj stanowisko usługi wobec numerów wirtualnych; niektóre je odrzucają.
• Miej gotową trasę zapasową, bo pokrycie tutaj często się zmienia.

Jeśli dopiero poznajesz ten model, czym jest bramka OTP wyjaśnia podstawy.

Które usługi mogą wysyłać kody na numery z Saint-Barthélemy?

Trasa obejmuje obecnie ponad 20 usług, czyli znacznie krótszy katalog niż większe rynki. Bieżące zestawienie zawiera TikTok, Amazon, LinkedIn, AliExpress, Flipkart, Mercado Libre, Mercado Pago, Coinbase, Bumble i Swiggy.

Ponieważ lista jest krótka i zmienia się w ciągu dnia, zawsze odczytuj dostępność z API w chwili zamówienia. Jeśli brakuje potrzebnej usługi, sąsiednia trasa Gwadelupy, która dzieli kod +590, albo trasa Francji może pasować do przypadku testowego w języku francuskim.

Krok po kroku: przepływ API dla routingu OTP z Saint-Barthélemy

1. Uwierzytelnij się w https://otproute.com/api/v1 kluczem Bearer zaczynającym się od or_live_ (do 10 kluczy na konto, 300 żądań na minutę).
2. Złóż zamówienie: POST /api/v1/activations z {"service": "linkedin", "country": "bl"}. Zachowaj identyfikator aktywacji i zwrócony numer.
3. Wprowadź numer +590 w aplikacji lub witrynie, którą testujesz.
4. Odbierz kod +590 ze zdarzenia activation.sms_received albo przejdź na polling GET /api/v1/activations/{id} co kilka sekund.
5. Zweryfikuj nagłówek X-OTPRoute-Signature w postaci t=<unix>,v1=<hex>, obliczając HMAC-SHA256 z "<t>.<raw body>" z sekretem endpointu, i odrzucaj nieaktualne znaczniki czasu.
6. Anuluj przez POST /api/v1/activations/{id}/cancel, jeśli test zakończy się wcześniej.

Przegląd dla deweloperów zbiera klucze, webhooki i przykłady w jednym miejscu.

Jak formatuje się i przechowuje numery +590?

Saint-Barthélemy używa kodu kraju +590 razem z Gwadelupą i francuską częścią Saint-Martin, zgodnie z francuskimi konwencjami numeracji. Lokalnie numery zapisuje się za pomocą dziesięciu cyfr i prefiksu krajowego 0: numery stacjonarne zwykle zaczynają się od 0590, a komórkowe od 0690. W E.164 0 jest odrzucane, więc numer komórkowy staje się +590 690 i sześć cyfr.

Jeden szczegół zaskakuje wiele zespołów: sam kod kierunkowy nie mówi, na którym terytorium mieszka klient. Jeśli Twój produkt pokazuje treści zależne od regionu, pytaj o terytorium osobno, zamiast wnioskować je z +590. Zapisuj ciąg E.164 bez spacji, a terytorium trzymaj w osobnym polu.

Językiem urzędowym jest francuski, więc wiadomości z kodem zwykle przychodzą po francusku lub angielsku, zależnie od tego, jak lokalizuje je usługa nadawcza.

Dlaczego zespół miałby testować lub działać na Saint-Barthélemy?

Gospodarka wyspy opiera się na turystyce, więc zwykle powodem są aplikacje podróżnicze, wynajmu willi, concierge, czarteru łodzi i hotelarskie. Zespoły chcą potwierdzić, że gość lub lokalny pracownik z numerem +590 może dokończyć rejestrację, a agencje prowadzące kampanie karaibskie dla hoteli czasem weryfikują tam profile biznesowe klientów. Kolejny powód to kontrola lokalizacji francuskojęzycznych przepływów na Karaibach, a stronę o takim zastosowaniu opisuje strona zespołów operacyjnych.

Rozwiązywanie problemów: kod nie dotarł

Każda aktywacja jest otwarta przez 20 minut, a płacisz tylko wtedy, gdy kod dotrze. Okno, które zamknie się puste, albo anulowane zamówienie automatycznie zwraca pełną kwotę do portfela, a Twój webhook otrzymuje activation.expired lub activation.cancelled.

• Poczekaj na pełne okno, zanim się poddasz.
• Sprawdź, czy usługa akceptuje numery wirtualne.
• Spróbuj ponownie później albo przełącz się na inną trasę usługi lub sąsiedni kraj.
• Nigdy nie zamawiaj ponownie w ciasnej pętli; rób przerwy między próbami.

Ścieżka bez kodu: zarejestruj się za pomocą e-maila i 6-cyfrowego kodu lub logowania przez Google, włącz TOTP, doładuj konto, wybierz Saint-Barthélemy i usługę, zaakceptuj wyświetlaną cenę i odczytaj kod w panelu.

Linie długoterminowe, rozliczenia i sandbox

Saint-Barthélemy nie ma samoobsługowego numeru długoterminowego. Linie dedykowane to produkt dla Stanów Zjednoczonych i Kanady, od $1.95/month; w sprawie trwałej linii +590 napisz na [email protected], ale dostępność zależy od lokalnych przepisów i nie jest gwarantowana.

Płatności odbywają się z jednego przedpłaconego portfela w USD, na zasadzie pay as you go, bez opłaty miesięcznej ani planu. Doładuj kartą lub USDT/USDC i otrzymuj fakturę PDF e-mailem za każde doładowanie. Konta deweloperskie mogą poprosić o tryb sandbox, który zwraca symulowane numery i kody, dzięki czemu integrację można przetestować end-to-end bez wydawania środków.

Używaj numerów +590 wyłącznie do własnych produktów i kont, przestrzegaj regulaminów poszczególnych usług i pamiętaj, że obowiązuje Polityka Dopuszczalnego Użytkowania OTP Route.

Najczęstsze pytania

Czy mogę odebrać kod weryfikacyjny z Saint-Barthélemy bez lokalnej karty SIM?

Tak, jeśli usługa jest w danej chwili na trasie. Zamów numer +590 z OTP Gateway i odczytaj kod w panelu lub przez API.

Jaki jest identyfikator kraju Saint-Barthélemy w API?

To bl, więc treść zamówienia wygląda jak {"service": "tiktok", "country": "bl"}.

Dlaczego lista usług dla Saint-Barthélemy jest taka krótka?

To mała trasa, a pokrycie często się zmienia. Sprawdź GET /api/v1/countries lub panel, aby zobaczyć aktualną listę, i rozważ Gwadelupę lub Francję jako alternatywy.

Czy +590 zawsze oznacza, że klient jest na Saint-Barthélemy?

Nie. Gwadelupa i francuska część Saint-Martin dzielą +590, więc zbieraj terytorium osobno, jeśli ma znaczenie dla Twojego produktu.

Ile kosztuje numer +590 do testów?

Od $0.20 za kod; dokładną kwotę ustala usługa, a API zwraca ją na żywo przed zamówieniem.

Czy tracę pieniądze, jeśli kod nigdy nie przyjdzie?

Nie. Po 20 minutach bez SMS-a, albo po anulowaniu, pełna kwota wraca do Twojego portfela.

Czy mogę zachować numer z Saint-Barthélemy do powtarzanych logowań?

Nie w modelu samoobsługowym. Numery dedykowane są dostępne tylko w USA i Kanadzie; napisz na [email protected], aby zapytać o inne opcje.

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.