Lista kontrolna odbierania kodów SMS z Bolt na numerach OTP Route

Gdzie Bolt prosi o numer telefonu?

Bolt, założona w Tallinie firma mobilnościowa stojąca za przejazdami, dostawą jedzenia i zakupów oraz wynajmem hulajnóg, buduje konta wokół numeru komórkowego. Aplikacja pasażera potwierdza ten numer jednorazowym kodem SMS przy rejestracji, a podobny kod zwykle wraca, gdy ktoś loguje się na nowym urządzeniu lub odzyskuje dostęp. Produkty dla kierowców, kurierów i firm działają podobnie.

Dla firmy oznacza to, że numer telefonu Bolt jest w praktyce kluczem konta. Zespoły prowadzące firmowe konto podróżne, sprawdzające, jak ich własna integracja partnerska zachowuje się w nowym mieście, albo chcące trzymać prywatną kartę SIM pracownika z dala od wspólnego loginu służbowego, potrzebują kontrolowanego sposobu na odebranie tego kodu.

Lista kontrolna przed zamówieniem numeru Bolt

Przejdź przez to, zanim cokolwiek wydasz:

• Cel jest legalny: konto należy do Twojej organizacji albo jest kontem testowym dla Twojego produktu, a regulamin Bolt na to pozwala.
• Rynek wybrany: kraj numeru odpowiada temu, gdzie konto będzie działać. Konto pasażera zarejestrowane na numer jednego kraju i używane gdzie indziej może zachowywać się inaczej.
• Klucz API gotowy: klucz Bearer z prefiksem or_live_, utworzony w konsoli deweloperskiej (do 10 na konto).
• Endpoint webhooka przetestowany: zasubskrybowany na activation.sms_received, z włączonym sprawdzaniem podpisu.
• Portfel zasilony: potwierdź przez GET /api/v1/balance albo poproś o tryb sandbox, aby przećwiczyć przepływ na symulowanych numerach.
• Plan awaryjny uzgodniony: zdecyduj z góry, co test robi, gdy kod nie wróci.

Które kraje obsługują trasy Bolt?

Trasy Bolt są obecnie wymienione dla 198 krajów. Przykłady to Estonia, Łotwa, Litwa, Polska, Czechy, Portugalia, Niemcy, Chorwacja, Malta, Gruzja, RPA, Nigeria, Kenia, Ghana, Tanzania i Uganda.

Wybierz kraj świadomie. Funkcje Bolt, opcje płatności i kontrole przy rejestracji różnią się zależnie od rynku, więc test w Warszawie niewiele mówi o przepływie w Nairobi. Dostępność w poszczególnych krajach zmienia się w ciągu dnia; GET /api/v1/prices i panel pokazują, co jest aktualnie dostępne.

Krok po kroku: API kodu weryfikacyjnego Bolt

1. Potwierdź identyfikator usługi przez GET /api/v1/services; dla Bolt to bolt.
2. Wybierz identyfikator kraju z GET /api/v1/countries, na przykład ee dla Estonii.
3. Odczytaj aktualną cenę: GET /api/v1/prices?country=ee&service=bolt.
4. Zamów: POST /api/v1/activations z treścią {"service": "bolt", "country": "ee"}. Zapisz identyfikator aktywacji i zwrócony numer.
5. Wpisz numer w aplikacji Bolt na urządzeniu testowym i poproś o SMS.
6. Obsłuż zdarzenie activation.sms_received. Zweryfikuj X-OTPRoute-Signature: t=<unix>,v1=<hex>, obliczając HMAC-SHA256 z <t>.<raw body> sekretem endpointu, odrzucaj stare znaczniki czasu i wiąż zapisy z identyfikatorem aktywacji, aby powtórne dostarczenie niczego nie zmieniło.
7. Jeśli webhooki nie wchodzą w grę, odpytuj GET /api/v1/activations/{id} co kilka sekund, daleko w granicach limitu 300 żądań na minutę.
8. Wywołaj POST /api/v1/activations/{id}/cancel, jeśli test zostaje porzucony.

Szczegóły endpointów są w dokumentacji API, a sprawdzanie podpisu wyjaśnia artykuł zabezpieczanie webhooków OTP.

Krok po kroku: ścieżka przez panel

Do pojedynczej weryfikacji SMS Bolt w testach albo jednorazowego założenia konta wystarczy przeglądarka. Zaloguj się, otwórz OTP Gateway, wybierz Bolt i rynek, sprawdź cenę i potwierdź. Skopiuj numer do aplikacji, poproś o kod i obserwuj, jak pojawia się na karcie zamówienia, zanim minie 20-minutowy zegar.

Rozwiązywanie problemów: kod z Bolt się nie pojawił

Puste okno nic nie kosztuje; gdy minie 20 minut bez SMS-a albo anulujesz, pełna kwota wraca do portfela. Typowe przyczyny i środki zaradcze:

• Bolt odrzucił numer: jak wiele platform, nie akceptuje numeru wirtualnego przy rejestracji w Bolt na każdym rynku. Spróbuj innej trasy krajowej, jeśli test na to pozwala, albo późniejszej próby.
• Wolne dostarczenie: czas zależy od usługi i trasy, więc dokończ okno, zanim anulujesz.
• Powtarzane żądania: wielokrotne stukanie „wyślij ponownie” lub zamawianie w pętli może uruchomić własne ograniczenia Bolt. Rozstaw próby w czasie.
• Zły rynek: numer z kraju, w którym Bolt nie działa w Twoim scenariuszu testowym, może nigdy nie zostać zaakceptowany.

Poradnik o routingu krajowym dla OTP opisuje wybór tras zapasowych.

Kiedy numer dedykowany jest lepszym wyborem?

Numer jednorazowy pasuje do pojedynczej weryfikacji. Jeśli konto Bolt musi się zalogować ponownie po kilku tygodniach, na przykład stagingowy profil pasażera używany wielokrotnie przez zespół QA albo login operacyjny weryfikowany ponownie na nowych urządzeniach, numer musi zostać przy Tobie. Robią to numery dedykowane, ale tylko w Stanach Zjednoczonych i Kanadzie, od $1.95/miesiąc, z przychodzącymi SMS-ami w panelu i przekazywanymi na webhook jako number.sms_received. Zanim na nim oprzesz plan, sprawdź, czy rynek Bolt konta działa z numerem amerykańskim lub kanadyjskim. Szczegóły na stronie numerów wirtualnych.

Odpowiedzialne korzystanie z numerów Bolt

Przestrzegaj regulaminu Bolt na każdym rynku. Trzymaj się jednego konta na jedną prawdziwą osobę lub firmę i używaj OTP Route wyłącznie do testowania własnych produktów albo obsługi legalnych kont należących do Twojej organizacji; zakładanie jednorazowych profili pasażera czy zbieranie promocji to niedozwolone użycie. Do każdego zamówienia stosuje się Acceptable Use Policy OTP Route, a Bolt jest znakiem towarowym swojego właściciela, bez sugerowania jakichkolwiek powiązań.

Najczęstsze pytania

Czy mogę odebrać OTP z Bolt bez lokalnej karty SIM?

Tak. Zamów numer dla usługi bolt we właściwym kraju, wpisz go w aplikacji i odczytaj kod w panelu lub przez API.

Jaki jest identyfikator usługi Bolt w API?

To bolt. Połącz go z identyfikatorem kraju, takim jak pl lub ke, wywołując POST /api/v1/activations.

Ile kosztuje numer do weryfikacji Bolt?

Od $0.20 za kod. Dokładna kwota zależy od kraju i wraca na żywo z GET /api/v1/prices.

Czy Bolt akceptuje każdy numer wirtualny?

Nie. Bolt może odrzucać numery wirtualne na niektórych rynkach lub w niektórych procesach, dlatego niedostarczony kod jest zwracany automatycznie.

Jaki kraj wybrać do testu Bolt?

Użyj kraju, w którym konto będzie faktycznie używane, aby zasady rejestracji, język i opcje płatności odpowiadały temu, co widzą prawdziwi użytkownicy.

Czy mogę zachować ten sam numer do przyszłych logowań w Bolt?

Nie z aktywacją jednorazową. Do powtarzanych logowań samoobsługową opcją jest numer dedykowany w USA lub Kanadzie.

Czy mogę przetestować przepływ, zanim zapłacę?

Tak. Poproś o tryb sandbox na koncie deweloperskim, aby dostawać symulowane numery i kody bez wydawania środków z portfela.

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.