Получение кодов подтверждения Shopee без личных телефонов

Зачем команде номера Shopee, которые никому лично не принадлежат?

Представьте команду, создающую интеграцию с маркетплейсом: синхронизацию заказов, инструмент возвратов или приложение для витрины. QA нужен аккаунт покупателя на конкретном рынке Shopee, чтобы пройти оформление заказа и убедиться, что интеграция работает. Кто-то берёт собственный телефон, и теперь тестовый аккаунт привязан к SIM-карте одного сотрудника в одной стране.

С той же проблемой сталкиваются агентства, открывающие магазины для клиентов, и продуктовые команды, готовящие запуск на новом рынке Юго-Восточной Азии. Виртуальный номер для Shopee оставляет эти проверки вне личных телефонов и позволяет выбрать страну, которой на самом деле касается тест. Как команды в этой сфере используют OTP Route, описывает страница маркетплейсов.

Когда Shopee запрашивает код по телефону?

Shopee тесно связывает аккаунты с номером телефона, и одноразовый код по SMS обычно появляется в таких случаях:

• Регистрация по номеру телефона в приложении или на сайте покупателя.
• Вход по коду или вход на устройстве, которым аккаунт ещё не пользовался.
• Сброс пароля и восстановление при его потере.
• Важные изменения, например смена номера телефона, email или платёжных данных.
• Аккаунты продавцов, проходящие телефонную верификацию при создании магазина.

Точные шаги различаются между страновыми сайтами Shopee и со временем меняются, поэтому воспринимайте это как общую схему, а не жёсткий регламент.

В каких странах можно получить код Shopee и почему это важно?

Маршрут Shopee доступен в 197 странах, включая Индонезию, Малайзию, Филиппины, Вьетнам, Таиланд, Сингапур, Тайвань, Бразилию, Мексику, Колумбию, Чили, Индию, США, Великобританию и Австралию.

Shopee работает с отдельными витринами по рынкам, и каждая, как правило, ожидает номер телефона своей страны. Поэтому выбирайте страну, соответствующую тестируемому аккаунту: тест малайзийской витрины требует малайзийского номера, а не любого, который оказался дешёвым. Соответствие рынку также делает тест реалистичным, потому что язык, валюта и шаги онбординга следуют за витриной.

Как работает API кодов подтверждения Shopee?

Используйте базовый URL https://otproute.com/api/v1 с Bearer-ключом с префиксом or_live_. Узнайте цену для вашего рынка через GET /api/v1/prices?country=my&service=shopee, затем создайте активацию через POST /api/v1/activations с телом {"service": "shopee", "country": "my"}. Идентификаторы стран берутся из GET /api/v1/countries.

Для доставки есть два варианта:

• Вебхук: подпишитесь на activation.sms_received, а также на activation.expired и activation.cancelled. Проверяйте заголовок X-OTPRoute-Signature, вычисляя HMAC-SHA256 от "<t>.<raw body>" с секретом эндпоинта, отклоняйте устаревшие метки времени и делайте обработчик идемпотентным, записывая каждый идентификатор активации один раз.
• Опрос: вызывайте GET /api/v1/activations/{id} с интервалом, пока код не появится или активация не завершится.

Статья о захвате OTP через вебхуки показывает готовый к продакшену приёмник.

Шаги в панели для продавцов и операционных сотрудников

API нужен не всем. В панели:

1. Зарегистрируйтесь по email с шестизначным кодом или через Google.
2. Пополните кошелёк картой или в USDT/USDC.
3. Откройте OTP Gateway, выберите Shopee и страну и проверьте актуальную цену.
4. Сделайте заказ, затем введите номер в поле телефона Shopee.
5. Прочитайте код, когда он появится рядом с номером.

У каждой активации 20-минутное окно. Вы платите, только если код пришёл; в противном случае сумма сама возвращается на кошелёк.

Почему код Shopee может не прийти?

Помешать может несколько причин. Shopee может отказывать виртуальным номерам на некоторых рынках или в некоторых сценариях, и автоматический возврат предусмотрен именно на этот случай. Маршруты также могут быть заняты в определённые часы, поскольку доставка зависит от сервиса и маршрута.

Что попробовать:

• Дайте окну отработать полные 20 минут, прежде чем сдаваться.
• Закажите снова позже или попробуйте маршрут другой страны, если тест это допускает.
• Разносите повторы во времени в автоматических тестах; повторные заказы в плотном цикле редко помогают.

Более полный список для сценариев маркетплейсов — в материале о снижении числа неудачных доставок OTP.

Когда лучше выделенный номер и каковы основные правила?

Одноразовый номер подходит для единичной верификации. Тестовому аккаунту покупателя, в который нужно войти снова на следующей неделе, или общему операционному логину, которому нужно восстановление, лучше подойдёт выделенный номер (Dedicated Number), остающийся у вас при продлении. Они доступны мгновенно в США и Канаде от $1.95/месяц, с входящими SMS в панели и на вашем вебхуке. Подробности — на странице виртуальных номеров.

Используйте OTP Route только для тестирования и работы с вашими законными аккаунтами и продуктами. Соблюдайте условия Shopee, держите один аккаунт на реального человека или компанию и помните, что действует Политика допустимого использования OTP Route. Shopee — товарный знак его владельца, и OTP Route не связан с ним.

Частые вопросы

Какой идентификатор сервиса у Shopee в API?

Это shopee. Сочетайте его с идентификатором страны, например {"service": "shopee", "country": "id"} для Индонезии.

Можно ли получить OTP Shopee для рынка, где я физически не нахожусь?

Да, если эта страна есть в маршруте. Закажите номер с рынка, витрину которого вы тестируете, и читайте код удалённо.

Принимает ли Shopee любой виртуальный номер?

Нет. Shopee может отклонять некоторые виртуальные номера, поэтому активация без полученного кода возвращается полностью.

Какой номер Shopee использовать для долгоживущего тестового аккаунта?

Если аккаунту нужно снова входить позже, лучше подойдёт выделенный номер США или Канады, который остаётся у вас, а не одноразовая активация.

Поддерживается ли SMS-верификация Shopee для тестирования в CI?

Да. Создавайте активации через API, получайте коды подписанным вебхуком или опросом и запросите аккаунт в песочнице, чтобы отрепетировать без трат средств.

Сколько стоит код Shopee?

От $0.20 за код; точная цена зависит от страны и возвращается в реальном времени методом GET /api/v1/prices.

Названия сервисов являются товарными знаками их владельцев. OTP Route не связан с ними. Используйте номера законно, соблюдайте условия каждого сервиса и нашу Политику допустимого использования.