Testy tureckiej weryfikacji na numerach +90 krok po kroku

Lista kontrolna: co przygotować, zanim zamówisz numer +90?

Krótka lista kontrolna oszczędza zmarnowane aktywacje, gdy turecki plan testów rusza na żywo:

1. Sprawdź identyfikator usługi w aplikacji przez GET /api/v1/services i potwierdź identyfikator kraju tr przez GET /api/v1/countries.
2. Wywołaj GET /api/v1/prices?country=tr&service=<id>, aby zobaczyć, ile para kosztuje w tej chwili i czy jest dostępna.
3. Upewnij się, że saldo portfela wystarczy na cały przebieg, za pomocą GET /api/v1/balance.
4. Zarejestruj endpoint webhooka (konto może mieć ich do pięciu) i nie trzymaj jego sekretu w repozytorium.
5. Ustaw w bibliotece do walidacji numerów region TR i zdecyduj, jak interfejs ma pokazywać numer testerowi.
6. Załaduj turecką lokalizację w środowisku testowym, bo błędy związane z wielkością liter ujawniają się tu zwykle jako pierwsze.

Dlaczego początkowe 0 psuje turecką walidację numerów?

W Turcji numery komórkowe zapisuje się z prefiksem krajowym, np. 0 5XX XXX XX XX. W formacie międzynarodowym zero znika: kanoniczna postać to +90 i dziesięciocyfrowy numer krajowy, a numery komórkowe po kodzie kraju zaczynają się od 5.

Formularze, które przyjmują oba style, wymagają kroku normalizacji. Usuń spacje i znaki interpunkcyjne, odetnij jedno początkowe 0, gdy region to TR, dodaj +90 i zapisz wynik w E.164 (+905…). Nigdy nie przechowuj zera z prefiksu krajowego, bo ten sam tester będzie w bazie wyglądał jak dwóch różnych użytkowników. Wyświetlaj numer w stylu krajowym, jeśli tego oczekują tureccy użytkownicy.

Jak turecki SMS weryfikacyjny wygląda z perspektywy Twojego parsera?

Językiem urzędowym jest turecki, a lokalni nadawcy piszą kody po turecku, używając liter takich jak ç, ş, ğ, ı, ö i ü. Aplikacje międzynarodowe zwykle trzymają się języka urządzenia lub konta. Tak czy inaczej, wyciągaj kod wzorcem cyfr, a nie dopasowując otaczające słowa.

Turecka lokalizacja kryje też znaną pułapkę programistyczną: zamiana małego i na wielkie daje kropkowane İ, a zamiana I na małe daje bezkropkowe ı. Kod porównujący ciągi z uwzględnieniem lokalizacji może zepsuć logowanie lub sprawdzanie adresów e-mail tureckich użytkowników. Test z numerem +90 to dobry moment, by to wyłapać, razem z maskami wejścia o właściwej długości i przetłumaczonymi komunikatami o błędach. Pokrewne kontrole opisuje przewodnik po weryfikacji w aplikacjach mobilnych.

Które aplikacje mogą kierować kody na turecki numer weryfikacyjny?

Bieżący zrzut dla tr obejmuje WhatsApp, Telegram, Instagram, TikTok, X (Twitter), Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Uber, Netflix, AliExpress, Discord, ChatGPT (OpenAI) i Amazon. Łącznie turecka trasa obsługuje ponad 1800 usług.

Zespoły zamawiają tu numery przy starcie tureckiego produktu, do sprawdzenia lokalizacji przed kampanią marketingową albo do obsługi tureckojęzycznych klientów mieszkających gdzie indziej w Europie. Ponieważ dostępność zmienia się w ciągu dnia, opieraj się na aktualnym cenniku, a nie na stałej liście w konfiguracji testów.

Jak zamówić i odczytać turecki kod OTP przez API?

Sekwencja wywołań jest krótka. Wyślij POST /api/v1/activations z {"service": "<id>", "country": "tr"} i kluczem Bearer z prefiksem or_live_. Zwrócony numer +90 wpisz w testowanej aplikacji. Gdy SMS dotrze, OTP Route wyśle activation.sms_received na Twój endpoint; jeśli okno minie wcześniej, dostaniesz activation.expired, a ręczne zatrzymanie wywoła activation.cancelled.

Zanim zaufasz jakiemukolwiek zdarzeniu, odtwórz podpis z nagłówka X-OTPRoute-Signature: HMAC-SHA256 z sygnatury czasowej, kropki i surowej treści żądania, z kluczem w postaci sekretu endpointu. Odrzucaj wszystko ze starą sygnaturą czasową, a powtórne dostarczenia dla tego samego identyfikatora aktywacji traktuj jako jedno zdarzenie. Odpytywanie GET /api/v1/activations/{id} to rozwiązanie zapasowe dla środowisk bez ruchu przychodzącego HTTP. Więcej znajdziesz we wpisie o przechwytywaniu OTP przez webhooki i w centrum dla deweloperów.

Wolisz klikać niż kodować? Użyj panelu

Osoby nietechniczne realizują tę samą logikę w przeglądarce. Zaloguj się, zasil portfel, wybierz usługę i Turcję, a potem skopiuj numer +90 do aplikacji. Przychodzący SMS pojawi się na karcie aktywacji. Każdy numer tymczasowy służy do jednego kodu w 20-minutowym oknie.

Co zrobić, gdy turecki kod nie nadchodzi?

• Odczekaj pełne 20 minut, zanim uznasz, że się nie udało.
• Sprawdź, czy aplikacja akceptuje numery wirtualne; niektóre je odrzucają i właśnie na ten przypadek istnieje automatyczny zwrot.
• Spróbuj ponownie nieco później albo inną trasą usługi, jeśli pozwala na to Twój test.
• Rozłóż ponowienia w czasie zamiast zamawiać w szybkiej pętli.

Zamówienie zakończone bez kodu nic nie kosztuje, bo cała kwota wraca do portfela.

Rozliczenia, sandbox i numery długoterminowe

OTP Route działa na przedpłaconym portfelu w USD, bez wyboru planu. Obsługiwane są zasilenia kartą oraz USDT/USDC, a każde z nich generuje fakturę PDF wysyłaną e-mailem. Deweloperzy mogą poprosić o przełączenie konta deweloperskiego na sandbox, który zwraca symulowane numery i kody do testów end-to-end bez wydawania środków.

Nie ma samoobsługowego długoterminowego numeru tureckiego. Zespoły, które go potrzebują, mogą napisać na [email protected]; odpowiedź zależy od lokalnych przepisów. Dla linii, które chcesz zachować i odnawiać, Numery dedykowane są oferowane w Stanach Zjednoczonych i Kanadzie od $1.95/month.

Najczęstsze pytania

Czy mogę zweryfikować rejestrację w aplikacji w Turcji bez tureckiej karty SIM?

Tak. Tymczasowy numer +90 z OTP Gateway odbiera kod, który odczytasz w panelu lub przez API.

Czy tureckie numery przechowywać z początkowym 0?

Nie. Zapisuj je w E.164 jako +90 i dziesięciocyfrowy numer krajowy, a zero z prefiksu krajowego dodawaj tylko przy wyświetlaniu formatu krajowego.

Jaki jest identyfikator kraju w API dla Turcji?

To tr. Przekaż go w polu country w POST /api/v1/activations oraz w zapytaniu o ceny.

Ile kosztuje numer +90 do testów?

Tureckie aktywacje zaczynają się od $0.20 za kod, a każda aplikacja ma własną stawkę. Panel i GET /api/v1/prices pokazują ją przed zamówieniem.

Co się stanie, jeśli kod nie zostanie dostarczony?

Jeśli w ciągu 20 minut nie nadejdzie żaden SMS albo anulujesz aktywację, pełna opłata wraca do Twojego portfela.

Czy turecki numer można zachować na późniejsze logowania?

Nie w modelu samoobsługowym. Napisz na [email protected], pamiętając, że dostępność zależy od lokalnych przepisów.

Czy istnieją zasady korzystania z tych numerów?

Tak. Tureckie numery służą do testowania i prowadzenia produktów oraz kont, które należą do Ciebie; nadal obowiązują regulaminy poszczególnych aplikacji oraz Zasady dopuszczalnego użytkowania 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.