Odbieranie kodów weryfikacyjnych Shopee bez prywatnych telefonów

Dlaczego zespół miałby potrzebować numerów Shopee, które nie należą do nikogo prywatnie?

Wyobraź sobie zespół budujący integrację z marketplace: synchronizację zamówień, narzędzie do zwrotów albo aplikację sklepową. QA potrzebuje konta kupującego na konkretnym rynku Shopee, aby przejść przez zakup i sprawdzić zachowanie integracji. Ktoś sięga po własny telefon i oto konto testowe jest przywiązane do karty SIM jednego pracownika w jednym kraju.

Z tym samym problemem mierzą się agencje zakładające sklepy dla klientów oraz zespoły produktowe przygotowujące start na nowym rynku Azji Południowo-Wschodniej. Numer wirtualny dla Shopee trzyma te kontrole z dala od prywatnych telefonów i pozwala wybrać kraj, którego test faktycznie dotyczy. Jak zespoły z tej branży używają OTP Route, opisuje strona marketplace.

Kiedy Shopee prosi o kod z telefonu?

Shopee ściśle wiąże konta z numerem telefonu, a jednorazowy kod SMS zwykle pojawia się w tych momentach:

• Rejestracja numerem telefonu w aplikacji kupującego lub na stronie.
• Logowanie kodem albo logowanie na urządzeniu, którego konto jeszcze nie używało.
• Reset hasła i odzyskiwanie po utracie hasła.
• Wrażliwe zmiany, takie jak edycja numeru telefonu, e-maila lub danych do wypłat.
• Konta sprzedawców, które przechodzą weryfikację telefonu przy zakładaniu sklepu.

Dokładne kroki różnią się między krajowymi serwisami Shopee i zmieniają się w czasie, więc traktuj to jako ogólny wzorzec, a nie sztywny regulamin.

Z jakich krajów można odbierać kod Shopee i dlaczego to ważne?

Trasa Shopee jest dostępna w 197 krajach, w tym w Indonezji, Malezji, na Filipinach, w Wietnamie, Tajlandii, Singapurze, na Tajwanie, w Brazylii, Meksyku, Kolumbii, Chile, Indiach, Stanach Zjednoczonych, Wielkiej Brytanii i Australii.

Shopee prowadzi osobne sklepy na każdym rynku, a każdy z nich zazwyczaj oczekuje numeru telefonu z własnego kraju. Wybierz więc kraj odpowiadający testowanemu kontu: test malezyjskiego sklepu wymaga numeru malezyjskiego, a nie byle jakiego, który akurat jest tani. Dopasowanie rynku utrzymuje też realizm testu, bo język, waluta i kroki onboardingu podążają za sklepem.

Jak działa API kodu weryfikacyjnego Shopee?

Użyj adresu bazowego https://otproute.com/api/v1 i klucza Bearer z prefiksem or_live_. Sprawdź cenę dla swojego rynku przez GET /api/v1/prices?country=my&service=shopee, a następnie utwórz aktywację przez POST /api/v1/activations z treścią {"service": "shopee", "country": "my"}. Identyfikatory krajów pochodzą z GET /api/v1/countries.

Do dostarczenia masz dwie opcje:

• Webhook: zasubskrybuj activation.sms_received oraz activation.expired i activation.cancelled. Zweryfikuj nagłówek X-OTPRoute-Signature, obliczając HMAC-SHA256 z "<t>.<raw body>" przy użyciu sekretu endpointu, odrzucaj nieaktualne znaczniki czasu i zadbaj o idempotentność handlera, zapisując każdy identyfikator aktywacji tylko raz.
• Odpytywanie: wywołuj GET /api/v1/activations/{id} w odstępach, aż kod się pojawi lub aktywacja się zakończy.

Artykuł o przechwytywaniu OTP przez webhooki pokazuje odbiornik gotowy do produkcji.

Kroki w panelu dla sprzedawców i pracowników operacyjnych

Nie każdy potrzebuje API. W panelu:

1. Zarejestruj się za pomocą e-maila i sześciocyfrowego kodu albo przez Google.
2. Zasil portfel kartą lub USDT/USDC.
3. Otwórz OTP Gateway, wybierz Shopee i kraj, a następnie sprawdź aktualną cenę.
4. Złóż zamówienie, a potem wpisz numer w polu telefonu Shopee.
5. Odczytaj kod, gdy pojawi się obok numeru.

Każda aktywacja ma okno 20 minut. Płacisz tylko wtedy, gdy kod dotrze; w przeciwnym razie kwota sama wraca do portfela.

Dlaczego kod Shopee może nie dotrzeć?

Kilka rzeczy może przeszkodzić. Shopee może odrzucać numery wirtualne na niektórych rynkach lub w niektórych przepływach, a automatyczny zwrot istnieje właśnie na taką sytuację. Trasy mogą być też zajęte o określonych porach, bo dostarczenie zależy od usługi i trasy.

Co spróbować:

• Poczekaj pełne 20 minut okna, zanim się poddasz.
• Zamów ponownie później albo spróbuj trasy innego kraju, jeśli test na to pozwala.
• Rozkładaj ponowienia w czasie w testach automatycznych; zamawianie w ciasnej pętli rzadko pomaga.

Pełniejszą listę rozwiązywania problemów dla przepływów marketplace znajdziesz w artykule o ograniczaniu nieudanych dostaw OTP.

Kiedy lepszy jest numer dedykowany i jakie są zasady?

Numer jednorazowy nadaje się do pojedynczej weryfikacji. Stagingowe konto kupującego, które musi zalogować się ponownie w przyszłym tygodniu, albo wspólny login operacyjny wymagający odzyskiwania, lepiej obsłuży numer dedykowany, który zatrzymujesz na czas odnowień. Są dostępne natychmiast w Stanach Zjednoczonych i Kanadzie od $1.95/month, z przychodzącymi SMS-ami w panelu i na twoim webhooku. Szczegóły na stronie numerów wirtualnych.

Używaj OTP Route wyłącznie do testowania i obsługi własnych, legalnych kont i produktów. Przestrzegaj regulaminu Shopee, utrzymuj jedno konto na rzeczywistą osobę lub firmę i pamiętaj, że obowiązuje Regulamin Dopuszczalnego Użytku OTP Route. Shopee jest znakiem towarowym swojego właściciela, a OTP Route nie jest z nim powiązany.

Najczęstsze pytania

Jaki jest identyfikator usługi Shopee w API?

To shopee. Połącz go z identyfikatorem kraju, np. {"service": "shopee", "country": "id"} dla Indonezji.

Czy mogę odebrać OTP Shopee dla rynku, na którym fizycznie nie jestem?

Tak, jeśli ten kraj jest na trasie. Zamów numer z rynku, którego sklep testujesz, i odczytaj kod zdalnie.

Czy Shopee akceptuje każdy numer wirtualny?

Nie. Shopee może odrzucać niektóre numery wirtualne, dlatego aktywacja, która nie otrzyma kodu, jest w całości zwracana.

Jakiego numeru telefonu Shopee użyć do długotrwałego konta testowego?

Jeśli konto musi się później zalogować ponownie, lepszym wyborem niż jednorazowa aktywacja jest numer dedykowany z USA lub Kanady, który zatrzymujesz.

Czy weryfikacja SMS Shopee do testów jest obsługiwana w CI?

Tak. Twórz aktywacje przez API, odbieraj kody przez podpisany webhook lub odpytywanie i poproś o konto sandbox, aby przećwiczyć wszystko bez wydawania środków.

Ile kosztuje kod Shopee?

Od $0.20 za kod; dokładna cena zależy od kraju i jest zwracana na żywo przez GET /api/v1/prices.

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.