Weryfikacja rejestracji +387, gdy nikt w zespole nie ma bośniackiej karty SIM

Wydanie wymaga testu +387, ale karta SIM leży w szufladzie w Sarajewie. Co teraz?

To częsty kłopot zespołów wdrażających produkt na Bałkanach Zachodnich. Product manager chce dowodu, że bośniaccy użytkownicy mogą się zarejestrować, lider QA ma na liście punkt „zweryfikuj lokalnym numerem”, a jedyna fizyczna karta +387 należy do kolegi, który odszedł wiosną.

Zwykłe powody, dla których zespół trafia w taką sytuację:

• Regionalny start obejmujący Bośnię i Hercegowinę obok Chorwacji, Serbii i Czarnogóry, gdzie ścieżka rejestracji każdego rynku wymaga osobnego sprawdzenia.
• Klienci z diaspory. Wiele osób mieszkających w Niemczech, Austrii, Szwecji i gdzie indziej nadal zachowuje numer +387, więc produkt fintechowy lub pokrewny telekomunikacji może widzieć bośniackie numery od użytkowników, którzy podczas rejestracji nigdy nie byli w kraju.
• Testy lokalizacji. Bośniacki, chorwacki i serbski są językami urzędowymi, a w codziennym użyciu pojawiają się zarówno alfabet łaciński, jak i cyrylica, więc teksty i walidacja formularzy zasługują na prawdziwy przebieg end-to-end.

Zamiast wysyłać karty SIM pocztą, OTP Route bierze routing OTP na siebie: OTP Gateway daje numer +387 na jedną weryfikację i przekazuje przychodzący SMS przez API weryfikacji SMS, które może wywołać Twój harness testowy.

Jakie aplikacje i platformy mogą wysyłać kody na bośniacki numer weryfikacyjny?

Zasięg to zrzut na żywo, więc potraktuj to jako punkt wyjścia, a nie stałe menu. W chwili pisania trasy dla Bośni i Hercegowiny obejmują Viber, WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, Microsoft & Outlook, LinkedIn, Discord, Uber, Amazon i eBay.

Łącznie kraj obsługuje ponad 1600 usług. Jeśli potrzebujesz numeru weryfikacyjnego z Bośni i Hercegowiny do usługi, której tu nie widać, najpierw sprawdź aktualną listę. Viber ma na Bałkanach większe znaczenie niż w wielu innych regionach, o czym warto pamiętać, jeśli Twój produkt wysyła kody także kanałami komunikatorów, a nie tylko SMS-em. Ponieważ dostępność zmienia się w ciągu dnia, pytaj API o bieżące opcje zamiast wpisywać listę na stałe w zestawie testów.

Jak krok po kroku przebiega przepływ API OTP dla Bośni i Hercegowiny?

W testach bośniackich skieruj klienta na https://otproute.com/api/v1 i podaj klucz or_live_ jako token Bearer. Klucze tworzy się w konsoli deweloperskiej; konto może mieć do 10 kluczy i 5 endpointów webhooków, z limitem 300 żądań na minutę.

1. Wywołaj raz GET /api/v1/services i GET /api/v1/countries, zapisz identyfikatory w pamięci podręcznej i potwierdź, że ba jest na liście.
2. Sprawdź koszt przez GET /api/v1/prices?country=ba&service=<id>, aby zadanie zapisało dokładną kwotę przed wydatkiem.
3. Wyślij POST /api/v1/activations z {"service": "<id>", "country": "ba"}. Odpowiedź zawiera identyfikator aktywacji i numer +387 do wpisania w testowanej aplikacji.
4. Czekaj na webhook activation.sms_received albo odpytuj GET /api/v1/activations/{id} w umiarkowanych odstępach, jeśli Twój runner nie przyjmuje ruchu przychodzącego.
5. Jeśli test zostanie przerwany, zwolnij numer przez POST /api/v1/activations/{id}/cancel, aby środki wróciły od razu.

W przypadku webhooków odczytaj nagłówek X-OTPRoute-Signature (t=<unix>,v1=<hex>), oblicz HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, porównaj w stałym czasie i odrzucaj przeterminowane znaczniki czasu. Ponieważ zdarzenia są oparte na identyfikatorze aktywacji, kod +387 dostarczony dwa razy powinien zostać zapisany tylko raz. Przewodnik integracji API OTP omawia ponowienia i obsługę błędów dokładniej.

Czy jest sposób bez kodu dla supportu lub operacji?

Tak. Osoba bez dostępu do API zrobi to samo w przeglądarce: zaloguje się, otworzy OTP Gateway, wybierze Bośnię i Hercegowinę oraz usługę, odczyta cenę i potwierdzi. Numer pojawia się na ekranie, a kod ukazuje się obok niego po odebraniu SMS-a. To dobre dla pracownika supportu odtwarzającego problem klienta z rejestracją albo lidera operacji sprawdzającego portal partnera po zmianie telefonu.

Jak przechowywać numery +387 i analizować bośniackie treści SMS?

W kraju bośniackie numery wybiera się z prefiksem międzymiastowym 0, a numery komórkowe zwykle zaczynają się od 06. W E.164 to zero znika: numer zapisany lokalnie jako 061 i sześć cyfr staje się +387 61 i tymi sześcioma cyframi. Przechowuj wyłącznie postać E.164, usuwaj spacje, myślniki i ukośniki przy wprowadzaniu i odrzucaj wszystko, co po kodzie kraju nadal ma początkowe zero.

Wiadomości weryfikacyjne mogą przychodzić po angielsku lub w jednym z języków lokalnych, a wiadomość napisana cyrylicą jest w pełni możliwa. Wyciągaj kod według wzorca cyfr, a nie szukając konkretnego słowa, i dopilnuj, aby logowanie zachowywało UTF-8, żeby znaki diakrytyczne takie jak č, ć, š i ž nie ulegały zniekształceniu podczas debugowania nieudanego przebiegu.

Co zrobić, gdy przebieg testu nie otrzyma kodu?

Nic nie jest pobierane, gdy kod nie dotrze. Jeśli SMS nie wpłynie w ciągu 20 minut albo wcześniej anulujesz, pełna kwota automatycznie wraca na portfel. Wtedy:

• Pozwól oknu dobiec końca, zamiast od razu zamawiać ponownie; spóźniony SMS nadal się liczy.
• Spróbuj ponownie nieco później albo wybierz inną trasę usługi dla tego samego scenariusza.
• Sprawdź, czy docelowa usługa w ogóle akceptuje numery wirtualne; niektóre ich nie przyjmują, i właśnie dlatego istnieje zwrot.
• Unikaj zamawiania w ciasnej pętli z CI, bo zużywa to limit żądań bez poprawy szans.

Ograniczanie nieudanych dostaw OTP opisuje wzorce, które zwykle pomagają.

Czy możemy zatrzymać bośniacką linię na dłużej i jak działa rozliczanie?

Nie jako produkt samoobsługowy. Numery Dedykowane, odnawiane z portfela od $1.95/month, są sprzedawane natychmiast tylko dla Stanów Zjednoczonych i Kanady. Jeśli zespół naprawdę potrzebuje długoterminowej linii +387, napisz na [email protected]; to, czy jest to możliwe, zależy od lokalnych przepisów i nie ma obietnicy, że uda się to załatwić.

Rozliczenia bramki opierają się na jednym przedpłaconym portfelu w USD, bez opłaty miesięcznej i bez wyboru planu. Środki można dodać kartą lub stablecoinami USDT/USDC; faktura PDF za każdą wpłatę trafia do Twojej skrzynki. Do prac integracyjnych konto deweloperskie można na prośbę przełączyć w tryb sandbox, który zwraca symulowane numery i kody, dzięki czemu Twój pipeline działa bez dotykania środków portfela. Aktualne stawki są na stronie cennika, a konto założysz za pomocą kodu e-mail lub logowania Google.

Najczęstsze pytania

Czy mogę przetestować bośniacką rejestrację w mojej aplikacji bez lokalnej karty SIM?

Tak. Zamów numer +387 dla swojej usługi w OTP Gateway, wpisz go w aplikacji i odczytaj kod w panelu lub z API.

Jakiego identyfikatora kraju używa OTP Route dla Bośni i Hercegowiny?

Identyfikator to ba. Podaj go jako pole country przy tworzeniu aktywacji i jako parametr zapytania country przy sprawdzaniu cen.

Czy płacę, jeśli kod +387 nigdy nie dotrze?

Nie. Jeśli nic nie dotrze w 20-minutowym oknie albo anulujesz zamówienie, pełna kwota automatycznie wraca na portfel.

Czy przy zapisie bośniackiego numeru komórkowego zachować początkowe zero?

Nie. Zapisuj numery w E.164, czyli +387 i numer bez krajowego zera prefiksu.

Czy numer +387 do testów nadaje się do konta, na które musimy zalogować się ponownie w przyszłym miesiącu?

Raczej nie, bo każdy numer z bramki obejmuje jedną weryfikację. Do powtarzanych logowań samoobsługową opcją jest numer dedykowany w USA lub Kanadzie; w sprawie bośniackiej linii długoterminowej zapytaj zespół e-mailem.

Czy mogę uruchamiać bośniackie testy OTP w CI bez wydawania pieniędzy?

Tak, prosząc o tryb sandbox na koncie deweloperskim. Zwraca on symulowane numery i kody, więc cały przepływ, łącznie z webhookami, można przećwiczyć za darmo.

Czy obowiązują zasady korzystania z tych numerów?

Tak. Przestrzegaj regulaminów poszczególnych usług, używaj numerów wyłącznie do własnych, legalnych produktów i kont, a pamiętaj, że do każdego zamówienia stosuje się Zasady dopuszczalnego użytku 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.