Как принимать коды подтверждения телефона Gojek через API

Как Gojek использует ваш номер телефона?

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

Поэтому каждому, кто интегрируется с Gojek или поддерживает его пользователей, рано или поздно нужен номер Gojek для тестирования. Если приложение предлагает выбрать канал доставки, выбирайте SMS, потому что номер OTP Gateway принимает текстовые сообщения.

Типичные причины, по которым команды запрашивают SMS-верификацию Gojek для тестирования:

• Партнёрская интеграция, например мерчантская или программа лояльности, которой в staging-прогоне нужен свежий логин Gojek.
• Сотрудники поддержки, воспроизводящие проблему входа клиента на чистом аккаунте, который они контролируют.
• Проверки локализации, подтверждающие, как экран ввода кода и таймер повторной отправки выглядят на бахаса-индонезийском и английском.

Почему страна тестового номера Gojek имеет значение?

Сервис gojek доступен в 197 странах OTP Route, но правильный выбор зависит от того, что вы проверяете. Большинство реальных аккаунтов Gojek индонезийские, поэтому естественный вариант по умолчанию — Индонезия (+62); индонезийские мобильные локально пишутся как 08…, а в формате E.164 становятся +62 8… после отбрасывания нуля в начале. Проверочные сообщения на индонезийских аккаунтах обычно приходят на бахаса-индонезийском.

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

Как выглядит работа с API для сервиса gojek?

Отправляйте запросы на https://otproute.com/api/v1 с Bearer-ключом, который начинается с or_live_.

1. Прочитайте GET /api/v1/prices?country=id&service=gojek, чтобы узнать актуальную цену и наличие на индонезийском маршруте.
2. Создайте заказ: POST /api/v1/activations с {"service": "gojek", "country": "id"}. Сохраните идентификатор активации.
3. Введите полученный номер в приложении Gojek и запросите код.
4. Получите код из activation.sms_received на вебхуке или опросите GET /api/v1/activations/{id}.
5. Вызовите POST /api/v1/activations/{id}/cancel, если тест прекращён.

Для вебхуков проверяйте заголовок X-OTPRoute-Signature (t=<unix>,v1=<hex>): вычислите HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта и отбрасывайте старые метки времени. Поскольку доставка может повторяться, сделайте обработчик идемпотентным: привяжите его к идентификатору активации и игнорируйте повторы. Опрос подходит для одиночных прогонов в рамках лимита 300 запросов в минуту. Полный справочник — в документации.

Можно ли получить OTP Gojek из личного кабинета?

Да. Выберите Gojek как сервис, укажите страну, подтвердите показанную цену и закажите. Введите номер в приложении, нажмите отправку кода и следите за карточкой активации: SMS появится на ней, как только придёт. Заказ остаётся открытым 20 минут, и если ничего не пришло или вы отменили его, вся сумма возвращается на баланс.

Почему SMS от Gojek может не прийти?

Несколько причин встречаются часто:

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

Когда лучше подойдёт выделенный номер?

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

Как сохранить тестирование Gojek ответственным?

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

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

Можно ли получить OTP Gojek без индонезийской SIM-карты?

Да. Закажите одноразовый номер +62 для сервиса gojek в OTP Gateway и прочитайте код в личном кабинете или через API.

Какой идентификатор сервиса Gojek в API OTP Route?

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

Всегда ли принимается виртуальный номер для Gojek?

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

Сколько времени активация Gojek остаётся открытой?

Двадцать минут. Если за это время SMS не пришло или вы отменили заказ, плата возвращается на баланс.

Можно ли позже использовать тот же номер для входа в Gojek?

Не с OTP Gateway, где на номер приходится один код. Для повторных входов рассмотрите американский или канадский Dedicated Number, если аккаунт это допускает.

Как избежать повторной обработки вебхуков с кодами Gojek?

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

Можно ли тестировать, не тратя деньги?

Да, по запросу аккаунт разработки можно перевести в песочницу, которая возвращает имитированные номера и коды.

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