Odbieranie bułgarskich kodów weryfikacyjnych na numerach +359

Czy zespół może odbierać bułgarskie kody SMS OTP bez lokalnej karty SIM?

Większość zespołów zadających to pytanie znajduje się w jednej z trzech sytuacji: produkt zaraz wchodzi na rynek bułgarski i QA chce zobaczyć prawdziwy proces rejestracji, regionalna grupa operacyjna zarządza profilami firmowymi zarejestrowanymi z kontaktem +359 albo agencja sprawdza z zagranicy onboarding klienta. Wysyłanie bułgarskich kart SIM na każdy taki przypadek jest wolne i zostawia plastik w szufladach.

OTP Gateway zastępuje to jednym żądaniem: wybierasz usługę i Bułgarię, dostajesz tymczasowy numer weryfikacyjny +359 i odczytujesz kod, gdy usługa go wyśle. Jeden numer obsługuje jedną weryfikację. Trasy zapewniają nasi partnerzy operatorscy, a OTP Route zajmuje się routingiem OTP, odliczaniem czasu i automatycznym zwrotem.

Jakie usługi mogę kierować przez numer +359?

Aktualny zrzut dla Bułgarii wymienia ponad 1600 usług. Do popularnych, dostępnych teraz należą WhatsApp, Viber, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, eBay, Uber, Discord i Signal.

Viber zasługuje na osobną wzmiankę, bo w Bułgarii jest szeroko używany do rozmów prywatnych i służbowych, więc lokalny plan QA często testuje go obok WhatsAppa. Dostępność tras zmienia się w ciągu dnia, dlatego ceny i listy usług pochodzą z API w momencie zapytania, a nie ze statycznej tabeli.

Jak wygląda sekwencja API OTP dla Bułgarii?

Utwórz klucz Bearer (prefiks or_live_) w konsoli deweloperskiej, a następnie wywołuj https://otproute.com/api/v1:

1. Jednorazowo pobierz GET /api/v1/services i GET /api/v1/countries i zapisz identyfikatory w pamięci podręcznej; Bułgaria to bg.
2. Odczytaj aktualną stawkę przez GET /api/v1/prices?country=bg&service=<id>.
3. Otwórz aktywację przez POST /api/v1/activations z treścią w rodzaju {"service": "viber", "country": "bg"}.
4. Czekaj na webhook activation.sms_received albo odpytuj GET /api/v1/activations/{id}, gdy Twój runner nie może wystawić endpointu.
5. Jeśli test zostanie przerwany wcześniej, wyślij POST /api/v1/activations/{id}/cancel, aby pieniądze wróciły od razu.

Sprawdzaj nagłówek X-OTPRoute-Signature w każdej dostawie (HMAC-SHA256 z znacznika czasu i surowej treści) i odrzucaj przeterminowane znaczniki. Dokumentacja dla deweloperów podaje limity konta: 10 kluczy, 5 endpointów webhooków, 300 żądań na minutę.

Jak przechowywać i normalizować numery +359?

Bułgarzy zapisują numery krajowo z początkowym prefiksem 0, więc numer komórkowy zapisany jako 088 123 4567 staje się w formie międzynarodowej +359 88 123 4567; zero znika po kodzie kraju. Przechowuj postać E.164, a formatuj tylko do wyświetlania. Jeśli formularz przyjmuje wpis lokalny, przed walidacją usuwaj spacje, myślniki i ten prefiks. Klasyczny błąd to zapisanie +3590…, pod który żadna trasa nic nie dostarczy.

Znaczenie ma też alfabet. Bułgarski zapisuje się cyrylicą, a usługi lokalizujące swoje teksty otaczają kod cyrylickimi słowami. Wiadomości cyrylickie są przesyłane w UCS-2, co skraca pojedynczy segment do 70 znaków, więc długi zlokalizowany szablon może dotrzeć podzielony. Jeśli wyrażenie regularne wyciąga cyfry, przetestuj je w otoczeniu cyrylicy, a nie tylko angielskiego.

Co zrobić, gdy kod nie dociera?

Pozwól oknu 20 minut dobiec końca, zanim wyciągniesz wnioski; niektóre aplikacje wysyłają z opóźnieniem albo dopiero po drugim kliknięciu „wyślij ponownie”. Jeśli nic nie przyjdzie, OTP Route automatycznie zwraca pełną kwotę na portfel, a zdarzenie activation.expired informuje Twój system, że slot się zamknął. Potem:

• Spróbuj później albo wybierz inną trasę dla tej samej usługi.
• Sprawdź, czy usługa akceptuje numery wirtualne; niektóre ich nie przyjmują, i właśnie dlatego istnieje zwrot.
• Rób przerwy między próbami zamiast zamawiać ponownie w ciasnej pętli.

Nasz tekst o ograniczaniu nieudanych dostaw OTP idzie dalej.

Czy jest długoterminowa linia bułgarska i jak działa rozliczanie?

Obecnie nie istnieje samoobsługowy, długoterminowy numer bułgarski. Numery Dedykowane to produkt dla USA i Kanady od $1.95/month; jeśli zespół potrzebuje stałej linii +359, napisz na [email protected], a zespół to sprawdzi, choć o możliwości zadecydują lokalne przepisy.

Płatności za kody +359 odbywają się przez jeden przedpłacony portfel w USD: bez opłaty miesięcznej i bez wyboru poziomu. Akceptowane są doładowania kartą i USDT/USDC, a faktura PDF za każde z nich trafia do Twojej skrzynki. Do prac integracyjnych poproś o przełączenie konta deweloperskiego w tryb sandbox, który zwraca symulowane numery i kody, dzięki czemu przepływ można przećwiczyć bez wydawania środków z portfela. Aktualne stawki są na stronie cennika.

Najczęstsze pytania

Czy mogę przetestować bułgarską rejestrację w mojej aplikacji bez lokalnej karty SIM?

Tak. Zamów numer +359 do testów w OTP Gateway, uruchom rejestrację w aplikacji i odczytaj kod w panelu lub przez API.

Jaki jest identyfikator kraju Bułgarii w API weryfikacji SMS?

Użyj bg w polu country w POST /api/v1/activations i w zapytaniach o ceny. Identyfikatory usług pochodzą z GET /api/v1/services.

Ile kosztuje bułgarski numer weryfikacyjny?

Bułgarskie kody zaczynają się od $0.20 za kod, a stawka zależy od usługi. Dokładną kwotę zwraca GET /api/v1/prices i pokazuje panel, zanim potwierdzisz.

Czy zapłacę, jeśli kod nigdy nie dotrze?

Nie. Gdy w ciągu 20 minut żaden SMS nie dotrze na numer albo wcześniej anulujesz, cała kwota automatycznie wraca na portfel.

Czy bułgarskie kody będą przychodzić cyrylicą, czy alfabetem łacińskim?

To zależy od usługi i ustawień językowych weryfikowanego konta. Zbuduj parser tak, by radził sobie z obydwoma alfabetami wokół cyfr.

Czy mogę zachować ten sam numer +359 na późniejsze logowania?

Nie przez OTP Gateway, bo każdy numer obsługuje jedną weryfikację. Numery długoterminowe są samoobsługowe tylko w USA i Kanadzie; w sprawie Bułgarii napisz na [email protected].

Czy OTP Route służy do rejestrowania wielu kont?

Nie. Służy do testowania i obsługi własnych, legalnych produktów i kont firmowych; przestrzegaj regulaminów poszczególnych usług, a obowiązują też Zasady dopuszczalnego użytku OTP Route.

Jak zacząć z numerami bułgarskimi?

Załóż konto za pomocą e-maila i 6-cyfrowego kodu lub logowania Google, zasil portfel, a potem zamawiaj z panelu albo wygeneruj klucz API.

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.