Получение OTP Tokopedia на маршрутизируемый номер для ваших тестовых и рабочих аккаунтов

Где Tokopedia запрашивает номер телефона?

Tokopedia — один из крупнейших интернет-маркетплейсов Индонезии, и, как большинство индонезийских коммерческих приложений, она считает номер телефона ключевой частью аккаунта. Номер Tokopedia обычно запрашивается при регистрации, используется для одноразовых кодов при входе на новом устройстве и проверяется снова перед важными изменениями, например правкой платёжных данных или сменой самого номера. Аккаунты продавцов проходят похожие шаги подтверждения.

Приложение может предлагать несколько каналов для кодов; OTP Route принимает SMS-канал, поэтому выбирайте SMS, когда приложение спросит. Сообщения обычно приходят на индонезийском.

Законные причины получать OTP Tokopedia на маршрутизируемый номер включают QA для инструмента продавца или интеграции с витриной, которую вы создаёте, агентства, ведущие аккаунты мерчантов от имени клиентов, и операционные команды, которые хотят вывести общий логин магазина из личной SIM-карты сотрудника. Эти схемы описывает страница решений для маркетплейсов.

Из какой страны должен быть номер для Tokopedia?

Актуальный снимок указывает Tokopedia в 197 странах. Подбирайте номер под реальный рынок аккаунта: номер Индонезии (+62) подходит типичному индонезийскому аккаунту продавца или покупателя, а номер из другой страны полезен для проверки того, как ваш продукт обрабатывает международный ввод телефона.

Среди других стран в списке — Малайзия, Сингапур, Бруней, Филиппины, Таиланд, Вьетнам, Индия, Австралия, Япония, Южная Корея, Гонконг, Тайвань, Великобритания, Нидерланды и США. Тестовый сценарий должен указывать ожидаемую страну, чтобы сбой указывал на сам поток, а не на несовпадающий маршрут.

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

Авторизуйтесь на https://otproute.com/api/v1 с помощью Bearer-ключа с префиксом or_live_. Идентификатор сервиса — tokopedia, а идентификатор страны Индонезии — id.

1. Проверьте GET /api/v1/prices?country=id&service=tokopedia, чтобы узнать актуальную цену и доступность.
2. Закажите номер через POST /api/v1/activations с телом {"service": "tokopedia", "country": "id"}.
3. Введите полученный номер на экране регистрации или входа, который вы тестируете, и запросите код по SMS.
4. Прочитайте результат из вашего вебхука или опрашивайте GET /api/v1/activations/{id}, пока код не появится.
5. Вызовите POST /api/v1/activations/{id}/cancel, если тест прерван, чтобы средства вернулись сразу.

Лимита аккаунта в 300 запросов в минуту для опроса более чем достаточно. Полные формы запросов и ответов — в документации API.

Как написать вебхук-обработчик для Tokopedia?

Направьте один из ваших пяти эндпоинтов вебхуков на маршрут, который слушает activation.sms_received, activation.expired и activation.cancelled по заказам Tokopedia. Каждая доставка содержит X-OTPRoute-Signature: t=<unix>,v1=<hex>; вычислите HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта, сравните за постоянное время и отказывайте устаревшим меткам времени.

Сделайте обработчик идемпотентным, привязав его к идентификатору активации, потому что повторная доставка не должна дважды завершать один и тот же тест. Если вы не хотите открывать эндпоинт, опрос работает не хуже для одного скрипта. Рабочий дизайн есть в руководстве по захвату вебхуков.

Может ли панель получить код Tokopedia без написания кода?

Да. Откройте OTP Gateway, выберите Tokopedia, укажите страну и подтвердите цену на экране. Скопируйте номер в приложение Tokopedia, выберите SMS как канал, и код появится рядом с активацией, как только будет получен. Руководитель операций мерчанта может сделать это, пока разработчики используют API с того же кошелька.

Почему OTP Tokopedia может не прийти?

Код могут остановить несколько причин: приложение может отклонять виртуальные номера в некоторых сценариях, ограничивать повторные запросы на один и тот же номер или отправить код по другому каналу, не SMS. В течение дня маршруты тоже работают по-разному.

Каждая активация длится 20 минут, и вы платите, только когда код пришёл. Если ничего не пришло, сумма автоматически возвращается на кошелёк. Дайте окну закончиться, повторите позже или через другой страновой маршрут, подходящий аккаунту, и избегайте повторных заказов в плотном цикле. Наше руководство по неудачным доставкам содержит дополнительные проверки.

Нужно ли аккаунту магазина Tokopedia выделенный номер?

Одноразовая активация подходит для теста свежей регистрации. Аккаунту магазина, в который нужно снова войти в следующем месяце, нужен номер, остающийся под вашим контролем, иначе будущему коду входа будет некуда прийти. Выделенные номера покрывают этот случай в США и Канаде, от $1.95/месяц, с входящими SMS в панели и пересылкой на ваш вебхук number.sms_received. Подойдёт ли номер США или Канады аккаунту Tokopedia, зависит от самого аккаунта, так что проверьте это, прежде чем на него полагаться.

Каковы правила ответственного тестирования Tokopedia?

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

Оплата идёт с предоплаченного кошелька в долларах США, пополняемого картой, USDT или USDC, со счётом в PDF за каждое пополнение и без абонентской платы. Аккаунты разработчиков могут запросить режим песочницы для имитированных сквозных тестов.

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

Можно ли протестировать вход Tokopedia в моём инструменте продавца без телефона сотрудника?

Да. Закажите активацию Tokopedia в OTP Gateway и прочитайте код в панели или через API.

Какой идентификатор сервиса использует API для Tokopedia?

Это tokopedia. Сочетайте его с идентификатором страны, например id для Индонезии.

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

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

Какая страна лучше всего подходит для номера Tokopedia?

Обычно Индонезия, поскольку именно там работает большинство аккаунтов, но выбирайте страну, соответствующую аккаунту и тестовому сценарию.

Спишутся ли деньги, если Tokopedia отправит OTP другим каналом?

Нет, если SMS на номер не пришло. Когда 20-минутное окно закрывается пустым, вся сумма возвращается на ваш кошелёк.

Как не дать повторным доставкам вебхука ломать мои тесты?

Сохраняйте обработанные идентификаторы активаций и игнорируйте повторы, предварительно проверив заголовок подписи в каждом запросе.

Можно ли надолго сохранить номер для аккаунта магазина Tokopedia?

Выделенные номера доступны в США и Канаде из панели; для других стран самообслуживаемой долгосрочной линии нет.

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