Programowe odbieranie kodów weryfikacyjnych +966 przy wdrożeniach w Arabii Saudyjskiej

Jak wygląda pojedyncza aktywacja +966 przez API?

Zacznijmy od wywołań, bo większość czytelników tej strony podłącza API weryfikacji SMS do zestawu testów lub wewnętrznego narzędzia. Wszystkie endpointy znajdują się pod https://otproute.com/api/v1 i wymagają klucza Bearer z prefiksem or_live_, tworzonego w konsoli Developer.

1. GET /api/v1/countries i GET /api/v1/services podają identyfikatory. Arabia Saudyjska to sa.
2. GET /api/v1/prices?country=sa&service=<id> zwraca aktualną stawkę dla tej pary; zapisz ją obok przebiegu testu.
3. POST /api/v1/activations z {"service": "<id>", "country": "sa"} zwraca identyfikator aktywacji i numer +966.
4. Test wpisuje numer w aplikacji, a kod przychodzi jako zdarzenie lub przez GET /api/v1/activations/{id}.
5. Jeśli test zostanie porzucony, POST /api/v1/activations/{id}/cancel zwalnia numer i zwraca środki do portfela.

GET /api/v1/balance przydaje się jako kontrola przed startem, aby nocne zadanie kończyło się błędem od razu i z czytelnym komunikatem, a nie w połowie przebiegu. Limity do uwzględnienia: 10 kluczy i 5 endpointów webhook na konto, 300 żądań na minutę.

Jak nasz odbiornik webhooków powinien traktować saudyjskie zdarzenia OTP?

Zarejestruj endpoint i zasubskrybuj activation.sms_received, activation.expired oraz activation.cancelled. Każde żądanie zawiera nagłówek X-OTPRoute-Signature w postaci t=<unix>,v1=<hex>.

• Odtwórz podpisany ciąg jako <t>.<raw body> i oblicz HMAC-SHA256 z sekretem tego endpointu.
• Porównaj wynik z v1 funkcją o stałym czasie działania i odrzuć wszystko, co ma zbyt stary znacznik czasu.
• Traktuj każde zdarzenie jako powiązane z identyfikatorem aktywacji, aby ponowne dostarczenie niczego nie zmieniło dwa razy.
• Odpowiadaj szybko kodem 2xx, a wolniejsze prace wykonuj w zadaniu w tle.

Odpytywanie pozostaje poprawnym rozwiązaniem zapasowym dla runnerów, które nie mogą przyjmować połączeń przychodzących. Więcej znajdziesz w naszych tekstach o przechwytywaniu OTP przez webhooki i zabezpieczaniu webhooków OTP przez HMAC.

Dlaczego zespoły produktowe testują z numerem +966?

Arabia Saudyjska to jeden z większych rynków cyfrowych w regionie Zatoki, a zespoły trafiają na tę stronę z praktycznych powodów: fintech przygotowujący onboarding dla mieszkańców Arabii Saudyjskiej, marketplace dodający sprzedawców z Zatoki, dostawca SaaS, którego klient wymaga regionalnej kontroli logowania, albo zespół operacyjny zarządzający kontami firmowymi dla biura w Rijadzie lub Dżuddzie. W każdym przypadku ktoś musi udowodnić, że proces działa z prawdziwym saudyjskim numerem weryfikacyjnym, a routing OTP przez bramkę oszczędza wysyłania kart SIM do regionu. Strona o onboardingu fintech opisuje ten scenariusz dokładniej.

Które usługi mogą odbierać kody na trasach saudyjskich?

Aktualny zrzut dla Arabii Saudyjskiej obejmuje ponad 1 000 usług. Często używane to m.in. Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail & YouTube), Telegram, Amazon, Microsoft & Outlook, LinkedIn, Discord i Netflix. Snapchat i X mają w Królestwie wyjątkowo liczną publiczność, przez co często trafiają na listę kontrolną lokalizacji. Zasoby zmieniają się w ciągu dnia, więc odpytuj API w momencie uruchomienia.

Jak formatować numery +966 i analizować arabskie wiadomości?

Lokalnie saudyjskie numery komórkowe zapisuje się z zerem wiodącym (prefiks krajowy), zwykle jako 05 i osiem cyfr. Forma międzynarodowa pomija to zero: +966 5 i pozostałe osiem cyfr. Normalizuj wszystko do E.164 już przy wprowadzaniu i usuwaj zero, jeśli użytkownik wpisze je po kodzie kraju.

Językiem urzędowym jest arabski, więc SMS-y weryfikacyjne mogą przychodzić po arabsku, po angielsku lub w obu językach. Arabski zapisuje się od prawej do lewej, a niektóre szablony mogą używać cyfr arabsko-indyjskich zamiast zachodnich. Parser, który przed dopasowaniem zamienia te cyfry na ASCII i zapisuje surowy UTF-8 w logach, oszczędza frustrującej klasy fałszywych błędów.

Czy jest ścieżka przez panel dla osób, które nie programują?

Tak. Zaloguj się do OTP Route, otwórz OTP Gateway, wybierz Arabię Saudyjską i usługę, sprawdź cenę i potwierdź. Numer pojawia się od razu, a po nadejściu kod wyświetla się obok niego. Konsultant wsparcia może w ten sposób w kilka minut odtworzyć problem klienta z rejestracją.

Co jeśli kod nie dotrze, a co z liniami długoterminowymi i rozliczeniami?

Jeśli SMS nie przyjdzie w ciągu 20 minut albo anulujesz zamówienie, cała kwota automatycznie wraca do portfela. Poczekaj do końca okna, spróbuj później lub przez inną trasę usługi, upewnij się, że usługa akceptuje numery wirtualne, i unikaj ponownego zamawiania w szybkiej pętli.

Samoobsługowy długoterminowy numer saudyjski nie istnieje. Numery dedykowane (Dedicated Virtual Numbers) są oferowane tylko w Stanach Zjednoczonych i Kanadzie, od $1.95/miesiąc; w sprawie długoterminowej linii +966 napisz na [email protected], pamiętając, że to lokalne przepisy decydują, czy jest to możliwe.

Środki pochodzą z jednego przedpłaconego portfela w USD, w modelu pay as you go, bez opłaty miesięcznej. Doładować można kartą oraz USDT/USDC, a każde doładowanie generuje fakturę PDF wysyłaną e-mailem. Konto deweloperskie można na prośbę przełączyć na sandbox, aby otrzymywać symulowane numery i kody. Aktualne stawki znajdziesz na stronie z cennikiem.

Najczęstsze pytania

Jak odebrać saudyjski SMS OTP przez API?

Utwórz aktywację z krajem sa i identyfikatorem usługi, a potem pobierz kod z webhooka activation.sms_received albo przez odpytywanie aktywacji.

Czy numer +966 do testów jest rozliczany, jeśli kod nie przyjdzie?

Nie. Brak kodu oznacza zwrot pełnej kwoty do portfela po zamknięciu 20-minutowego okna lub po anulowaniu.

Czy mogę przetestować rejestrację w mojej aplikacji dla Arabii Saudyjskiej bez lokalnej karty SIM?

Tak. OTP Gateway wydaje numer +966 na jeden kod, który wpisujesz w aplikacji i odczytujesz z powrotem w panelu lub przez API.

Jak zapisać saudyjski numer komórkowy wpisany jako 05XXXXXXXX?

Usuń zero wiodące i zapisz go jako +966 5 plus pozostałe osiem cyfr w formacie E.164.

Czy możemy zachować ten sam saudyjski numer do późniejszych logowań?

Nie w produkcie samoobsługowym, ponieważ długoterminowe numery dedykowane obejmują tylko USA i Kanadę. Napisz do zespołu, jeśli potrzebujesz linii saudyjskiej, bez gwarancji, że da się ją zapewnić.

Czy mogę przećwiczyć saudyjski przepływ, zanim w grę wejdą prawdziwe pieniądze?

Tak. Poproś o tryb sandbox dla konta deweloperskiego, aby otrzymywać symulowane numery i kody, razem z webhookami.

Jakie użycie dopuszcza OTP Route?

Testowanie i obsługę własnych, legalnych produktów i kont. Przestrzegaj regulaminu każdej usługi; obowiązują 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.