Lista kontrolna przed odbieraniem kodów weryfikacyjnych +375 z Białorusi

Co powinno być gotowe, zanim zamówisz numer +375?

Zanim użyjesz numeru +375 do testów, odhacz poniższe punkty:

• Konto i zasilony portfel. Załóż je na stronie rejestracji za pomocą adresu e-mail i 6-cyfrowego kodu z e-maila albo logowania przez Google, a następnie dodaj niewielkie saldo. Włącz uwierzytelnianie dwuskładnikowe TOTP na koncie, które przechowuje klucze API.
• Klucz Bearer z prefiksem or_live_, utworzony w konsoli deweloperskiej. Daj CI i lokalnemu środowisku osobne klucze; konto może mieć ich do 10.
• Dwa identyfikatory, które wyślesz. Białoruś to w API by, a identyfikator usługi to wartość api_service zwracana przez GET /api/v1/services.
• Endpoint odbierający, jeśli planujesz webhooki, z sekretem podpisu przechowywanym poza repozytorium.
• Konto testowe w Twoim produkcie, które może zmienić lub dodać numer telefonu.
• Biblioteka telefonów skonfigurowana dla regionu BY, aby numer wklejony w formularzu rejestracji był parsowany tak, jak wpisałby go prawdziwy białoruski użytkownik.

Jak zapisuje się białoruskie numery i jak aplikacja powinna je przechowywać?

Białoruś używa kodu kraju +375 i dziewięciocyfrowego numeru krajowego. Linie komórkowe zaczynają się od kodów operatorów, takich jak 25, 29, 33 lub 44, więc zapisana wartość wygląda jak +37529XXXXXXX.

Kłopot sprawia krajowy zwyczaj. Mieszkańcy często zapisują numer komórkowy z początkowym 80, na przykład 8 029 XXX-XX-XX, co wywodzi się z prefiksu połączeń międzymiastowych. To 80 trzeba usunąć, zanim dodasz kod kraju; formularz, który je zachowa, tworzy nieprawidłowy ciąg E.164, który niektóre usługi weryfikacyjne odrzucają po cichu. Dobre testy normalizacji dla białoruskiego numeru weryfikacyjnego:

• akceptuj +375 29 ..., 375 29 ... i 8 029 ... i zapisuj wszystkie trzy identycznie;
• wyświetlaj numer w grupowaniu przyjaznym lokalnie, ale do warstwy SMS lub weryfikacji wysyłaj wyłącznie E.164;
• odrzucaj numer, który po 375 nadal ma 80.

Białoruski i rosyjski są językami urzędowymi, a rosyjski jest tym, którego większość osób używa na co dzień. Wiele usług wysyła treść kodu po rosyjsku lub angielsku, zależnie od ustawień regionalnych konta, więc sprawdź, czy Twoja aplikacja poprawnie wyświetla cyrylicę na każdym ekranie, który powtarza treść wiadomości.

Dla jakich usług białoruski numer weryfikacyjny może odbierać kody?

Routing OTP dla Białorusi w OTP Route obejmuje obecnie ponad 1400 usług pod identyfikatorem by. Popularne trasy w bieżącym przeglądzie to Telegram, Viber, WhatsApp, Signal, Google (Gmail & YouTube), Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Amazon i AliExpress.

Dostępność pojedynczej trasy zmienia się w ciągu dnia, więc traktuj taką listę jako punkt wyjścia, a nie obietnicę. Przed przebiegiem zapytaj GET /api/v1/prices?country=by&service=<id> o bieżącą cenę i o to, czy trasa może teraz przyjąć zamówienie. Przy wyborze między krajami zajrzyj do tekstu o routingu OTP według krajów.

Krok po kroku: przepływ Belarus OTP API ze skryptu testowego

Każde żądanie trafia na https://otproute.com/api/v1 z Twoim kluczem Bearer. API do weryfikacji SMS jest na tyle małe, że da się je opakować w jednego pomocnika:

1. Wywołaj GET /api/v1/balance i zakończ zadanie wcześniej, jeśli portfel jest zbyt ubogi na cały zestaw testów.
2. Wywołaj GET /api/v1/prices?country=by&service=telegram (podstaw swój identyfikator usługi) i zapisz w logu cenę, którą zamierzasz zapłacić.
3. Utwórz zamówienie przez POST /api/v1/activations z treścią w rodzaju {"service": "telegram", "country": "by"}. Zapisz identyfikator aktywacji i numer +375 z odpowiedzi.
4. Wyślij ten numer do kroku telefonu we własnej aplikacji i wywołaj kod.
5. Odbierz kod ze zdarzenia activation.sms_received albo odpytuj GET /api/v1/activations/{id}. Limit to 300 żądań na minutę.
6. Jeśli test się przerwie, wywołaj POST /api/v1/activations/{id}/cancel, aby zablokowane środki od razu wróciły do portfela.

W przypadku webhooków odczytaj nagłówek X-OTPRoute-Signature (t=<unix>,v1=<hex>), oblicz HMAC-SHA256 z <t>.<raw body> za pomocą sekretu endpointu, porównaj w stałym czasie i odrzucaj dostarczenia z nieaktualnym znacznikiem czasu. Oprzyj handler na identyfikatorze aktywacji, aby powtórne dostarczenie było nieszkodliwe. Szczegóły omawiają dokumentacja API i przewodnik po zabezpieczaniu webhooków OTP przez HMAC.

Krok po kroku: to samo zadanie z panelu

Pracownicy wsparcia, którzy od czasu do czasu potrzebują kodu, mogą pominąć API:

1. Otwórz OTP Gateway w panelu i wybierz Białoruś.
2. Wybierz usługę; cena dla tej trasy pojawi się przed zatwierdzeniem.
3. Skopiuj numer +375 i wpisz go w testowanej aplikacji.
4. Obserwuj kartę zamówienia. Kod pojawi się na niej, gdy tylko dotrze.

Jeśli w ciągu 20 minut nic nie przyjdzie, zamówienie się zamknie, a pełna kwota zostanie zwrócona. Płacisz tylko wtedy, gdy kod zostanie dostarczony.

Rozwiązywanie problemów: kod +375 nie dotarł

Typowe przyczyny i kolejny krok dla każdej z nich:

• Usługa odrzuciła numer. Niektóre platformy odrzucają numery wirtualne. Zasada zwrotu istnieje właśnie na taki przypadek; spróbuj innej trasy usługi lub innego kraju, jeśli test na to pozwala.
• Numer wpisano w formie krajowej. Sprawdź ponownie, czy formularz wysłał +375 i dziewięć cyfr, bez 80.
• Trasa jest zajęta. Pozwól oknu dobiec końca, zamiast anulować po minucie, a potem spróbuj ponownie później.
• Skrypt ponawia zamówienia w ciasnej pętli. Dodaj opóźnienie między próbami; szybkie powtórne zamówienia dla jednej usługi rzadko pomagają i mogą wyglądać na nadużycie dla platformy docelowej.

Dalsze wzorce niepowodzeń dla zamówień +375 omawia tekst o ograniczaniu nieudanych dostarczeń OTP.

Czy jest białoruska linia długoterminowa i jak działają rozliczenia?

Nie. OTP Route nie ma samoobsługowego numeru długoterminowego dla Białorusi. Jeśli Twój zespół potrzebuje go do zastosowań operacyjnych lub wsparcia, napisz na [email protected] i opisz scenariusz; to, czy da się coś zaoferować, zależy od lokalnych przepisów i niczego nie obiecujemy. Numery dedykowane (Dedicated Virtual Numbers) to produkt dla USA i Kanady, od $1.95/month, z odbiorem SMS, wysyłaniem SMS i połączeniami w przeglądarce.

Białoruskie zamówienia korzystają z tego samego przedpłaconego portfela w USD co każda inna trasa, bez opłat miesięcznych i bez wyboru poziomu. Zasilisz go kartą albo stablecoinami USDT/USDC; faktura PDF za każde zasilenie trafia do Twojej skrzynki. Programiści mogą poprosić o konto sandbox, które zwraca symulowane numery i kody, co jest najtańszym sposobem sprawdzenia integracji przed prawdziwymi zamówieniami. Używaj każdego numeru wyłącznie do własnego produktu lub własnych legalnych kont, przestrzegaj regulaminu każdej usługi i pamiętaj, że obowiązuje Polityka dozwolonego użytkowania OTP Route. Aktualne kwoty znajdziesz w cenniku.

Najczęstsze pytania

Czy mogę przetestować proces rejestracji w mojej aplikacji dla Białorusi bez lokalnej karty SIM?

Tak. Zamów numer +375 dla swojej usługi w OTP Gateway, wpisz go w formularzu rejestracji i odczytaj kod w panelu lub przez API.

Jaki jest identyfikator kraju dla Białorusi w API OTP Route?

To by. Użyj go w GET /api/v1/prices oraz w treści POST /api/v1/activations.

Czy powinienem przechowywać białoruskie numery z prefiksem 80?

Nie. Zapisuj je w E.164 jako +375 i dziewięć cyfr, a krajowe 80 pomijaj, bo w przeciwnym razie wiele usług uzna numer za nieprawidłowy.

Co dzieje się z moimi pieniędzmi, jeśli numer +375 nie otrzyma kodu?

Gdy 20-minutowe okno kończy się bez SMS-a albo anulujesz zamówienie, pełna opłata automatycznie wraca do portfela.

W jakim języku będzie SMS weryfikacyjny?

Decyduje o tym usługa wysyłająca. Dla białoruskich numerów jest to zwykle rosyjski lub angielski, zależnie od języka konta lub urządzenia.

Czy mogę zatrzymać numer +375 na potrzeby przyszłych logowań?

Nie w trybie samoobsługowym. Długoterminowe Numery dedykowane istnieją tylko dla USA i Kanady; w sprawie Białorusi możesz napisać na [email protected] z pytaniem, bez obietnicy dostępności.

Czy można przetestować integrację bez wydawania środków z portfela?

Tak. Na prośbę konto deweloperskie można przełączyć na sandbox, który zwraca symulowane numery i kody do testów od początku do końca.

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.