Polskie (+48) kody weryfikacyjne: lista kontrolna, kroki API i poprawki

Przed startem: czego potrzebuję, aby testować polskie rejestracje?

Przejdź tę listę raz, a pierwsze polskie zamówienie zwykle przebiegnie bez niespodzianek:

1. Poświadczenia. Wygeneruj klucz Bearer w konsoli deweloperskiej (zaczyna się od or_live_). Osobne klucze dla stagingu, CI i produkcji ułatwiają rotację.
2. Identyfikatory. Polska to pl. Identyfikatory usług pobieraj z GET /api/v1/services, zamiast wpisywać na sztywno nazwy wyświetlane.
3. Środki. Zasil portfel; każda cena jest widoczna przed zamówieniem.
4. Cel dostarczania. Zarejestruj webhook HTTPS i trzymaj jego sekret poza repozytorium kodu. Polling też działa, jeśli ruch przychodzący jest blokowany.
5. Budżet żądań. API dopuszcza 300 żądań na minutę na konto, więc odpowiednio ograniczaj równoległe zestawy testów.
6. Zakres. Weryfikuj wyłącznie konta należące do Twojego produktu, firmy lub klienta i przestrzegaj regulaminu każdej usługi oraz naszych Zasad dopuszczalnego użytkowania.

W przypadku pipeline’ów zajrzyj do artykułu o testowaniu SMS OTP w pipeline’ach CI.

Które usługi wysyłają obecnie kody na numery +48?

W routingu OTP Polska należy do szerszych pozycji katalogu i obejmuje ponad 2 300 usług. Aktualna migawka popularnych obejmuje Facebook, Instagram, TikTok, WhatsApp, Telegram, Viber, Signal, Snapchat, Discord, X (Twitter), LinkedIn, Google (Gmail & YouTube), Amazon, AliExpress, Uber i Netflix.

Traktuj tę listę jako punkt wyjścia, a nie obietnicę. Dostępność na każdej trasie zmienia się w ciągu dnia, więc przed każdym zamówieniem zapytaj endpoint cen o konkretną parę.

Jakie są dokładne kroki dla API OTP dla Polski?

Korzystając z API weryfikacji SMS pod adresem https://otproute.com/api/v1, zautomatyzowany test wykonuje następujące czynności:

1. GET /api/v1/prices?country=pl&service=<id> potwierdza aktualną cenę usługi w Polsce.
2. POST /api/v1/activations z {"service": "<id>", "country": "pl"} zwraca numer +48 i identyfikator aktywacji.
3. Test wpisuje numer w formularzu rejestracji i prosi o wysłanie SMS-a.
4. Handler odbiera activation.sms_received; jeśli zobaczy activation.expired lub activation.cancelled, oznacza uruchomienie jako niedostarczone.
5. Bez webhooka odczytuj GET /api/v1/activations/{id} co kilka sekund, aż pojawi się kod albo skończy się okno.
6. Wywołaj POST /api/v1/activations/{id}/cancel, gdy test jest wcześniej zamykany.

Zweryfikuj nagłówek X-OTPRoute-Signature, zanim zaufasz jakiejkolwiek zawartości: zawiera on t=<unix>,v1=<hex>, gdzie v1 to HMAC-SHA256 z <t>.<raw body> podpisany sekretem endpointu. Odrzucaj wszystko ze starym znacznikiem czasu i zadbaj, by handler był idempotentny względem identyfikatora aktywacji. Przewodnik po zabezpieczaniu webhooków pokazuje tę kontrolę szczegółowo.

Czy mój zespół operacyjny może zamówić polski numer bez API?

Tak. W panelu OTP Route otwórz OTP Gateway, wybierz Polskę, wyszukaj usługę i potwierdź wyświetloną cenę. Po zamówieniu skopiuj polski numer weryfikacyjny na ekran weryfikacji w aplikacji i obserwuj kartę aktywacji; treść SMS-a pojawi się tam po jego otrzymaniu. Niczego nie trzeba instalować, a ten sam portfel zasila zarówno przeglądarkę, jak i API.

Co sprawia, że polskie numery i wiadomości wymagają innej obsługi?

Polska stosuje zamknięty plan numeracyjny bez prefiksu krajowego: każdy numer, komórkowy czy stacjonarny, ma dziewięć cyfr po +48. Dzięki temu walidacja jest przyjemnie ścisła. Odrzucaj dane, które nie redukują się do dziewięciu cyfr krajowych, usuwaj spacje i myślniki, które użytkownicy dodają w grupach po trzy, i zapisuj +48 oraz dziewięć cyfr jako jeden ciąg E.164. Przypadkowe wiodące zero to literówka, a nie prefiks do zachowania.

Wiadomości weryfikacyjne często przychodzą po polsku, gdy język konta jest polski. Znaki takie jak ą, ę, ł i ż wykraczają poza 7-bitowy alfabet GSM, więc jeśli wysyłasz własne polskie SMS-y z kodami, spodziewaj się krótszych segmentów i testuj szablon tak, jak faktycznie wyświetla go telefon. Przy parsowaniu przychodzących kodów opieraj się na cyfrach i ignoruj otaczające je słowa.

Typowe powody testów tutaj: produkt wchodzący na polski rynek, lokalizacyjne QA polskojęzycznych procesów, zespoły regionalne zajmujące się kontami firmowymi w Europie Środkowej oraz aplikacje, których klienci obejmują osoby mówiące po polsku mieszkające gdzie indziej w UE.

Rozwiązywanie problemów: dlaczego brakuje kodu +48?

• Okno nadal jest otwarte. Daj mu pełne 20 minut, zanim cokolwiek stwierdzisz; płacisz tylko wtedy, gdy kod dotrze.
• Usługa może odrzucać numery wirtualne. Niektóre platformy to robią, a wtedy automatyczny zwrot przywraca pełną kwotę do portfela.
• Trasa jest zajęta. Spróbuj później albo przetestuj inną trasę usługi.
• Test działa w pętli. Zamawianie ponownie co kilka sekund zużywa budżet żądań; dodaj opóźnienie.

Więcej wzorców zebrano w tekście o ograniczaniu nieudanych dostaw OTP.

Czy Polska ma numery dedykowane i jak działają płatności?

Nie jako produkt samoobsługowy. Dedykowane Numery wirtualne, od $1.95/miesiąc, są oferowane tylko w Stanach Zjednoczonych i Kanadzie. W sprawie długoterminowej linii polskiej napisz na [email protected]; o tym, czy to możliwe, decydują lokalne przepisy, więc nie ma obietnicy.

Płatności trafiają do jednego przedpłaconego portfela w USD: bez planu, bez opłaty miesięcznej, z doładowaniami kartą lub USDT/USDC i fakturą PDF wysyłaną e-mailem po każdym z nich. Deweloperzy mogą poprosić o tryb sandbox na koncie deweloperskim, aby podczas budowy integracji otrzymywać symulowane numery i kody. Aktualne stawki znajdziesz w cenniku.

Najczęstsze pytania

Jak przetestować polski proces rejestracji, jeśli nikt w zespole nie ma karty SIM +48?

Zamów numer +48 do testów w OTP Gateway i użyj go w procesie. Kod pojawi się w panelu i może zostać wysłany na Twój webhook.

Jaki jest identyfikator Polski w wywołaniach API OTP Route?

To pl, używane zarówno w POST /api/v1/activations, jak i w zapytaniu o ceny.

Ile cyfr ma polski numer telefonu?

Dziewięć cyfr krajowych po +48, bez zera prefiksu. Ta stała długość upraszcza walidację po stronie serwera.

Ile kosztuje odebranie SMS-a OTP z Polski?

Ceny zaczynają się od $0.20 za kod i różnią się w zależności od usługi. Panel i endpoint cen pokazują dokładną kwotę przed zamówieniem.

Czy stracę pieniądze, jeśli polska aktywacja wygaśnie pusta?

Nie. Aktywacja, która kończy się bez kodu, lub taka, którą anulujesz, jest zwracana do portfela w całości.

Czy mogę zasymulować cały proces dla Polski przed uruchomieniem na żywo?

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.