Как команды получают SMS-коды DiDi для тестирования и операционной работы

Ситуация: аккаунт сервиса мобильности держится на одном номере телефона

DiDi — платформа вызова такси и мобильности, и, как и большинство приложений этой категории, она считает мобильный номер основой аккаунта. SMS-код обычно запрашивается при регистрации, при входе с нового устройства и при восстановлении аккаунта; подключение водителей и курьеров опирается на ту же проверку.

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

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

Маршрут didi сейчас охватывает 198 стран. Чаще всего команды начинают с рынков с высоким спросом на такси, например Мексика, Бразилия, Чили, Колумбия, Перу, Аргентина, Коста-Рика, Панама, Доминиканская Республика, Эквадор, Австралия, Новая Зеландия, Япония и Гонконг.

Выбирайте страну сознательно. Аккаунт пассажира, которым будут пользоваться в Сантьяго, нужно подтверждать чилийским номером, а регрессионному тесту мексиканского экрана регистрации нужен мексиканский. Несовпадение страны номера и рынка аккаунта — частая причина того, что тест формально проходит, а с настоящим приложением не работает. Полный список — в разделе страны.

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

Для DiDi используется тот же базовый URL, что и для любого другого маршрута, https://otproute.com/api/v1, с ключом or_live_ в заголовке Authorization.

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

На аккаунте может быть до 10 ключей и 5 вебхук-эндпоинтов, в пределах 300 запросов в минуту.

Как написать обработчик вебхука DiDi?

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

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

Получение OTP DiDi из личного кабинета

Операционные сотрудники могут вообще обойтись без API. Войдите, пополните баланс, откройте OTP Gateway, найдите DiDi, выберите страну, соответствующую аккаунту, и проверьте показанную цену до подтверждения. Номер появится на карточке активации, а код — на ней же, когда DiDi его отправит. Активация остаётся открытой 20 минут.

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

Пустую активацию объясняют несколько обычных причин:

• DiDi, как и многие платформы, может отклонять виртуальные номера на некоторых маршрутах или в некоторое время.
• Маршрут выбранной страны может быть занят; наличие меняется в течение дня.
• Приложение может ограничивать повторные запросы с одного устройства или сессии во время тестирования.

Лекарство — терпение, а не напор. Дайте окну закончиться, попробуйте позже или с другой страной, которая по-прежнему подходит для теста, и не заказывайте заново в плотном цикле. За промах вы никогда не платите: когда окно закрывается или вы отменяете заказ, вся сумма автоматически возвращается на баланс.

Когда аккаунт DiDi стоит держать на Dedicated Number и какие правила действуют?

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

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

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

Какой идентификатор сервиса для SMS-верификации DiDi при тестировании?

Используйте didi в поле service вместе с идентификатором страны рынка, который вы тестируете.

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

Да, если маршрут Мексики открыт: закажите номер со страной mx и сервисом didi, затем прочитайте код через API или в кабинете.

Платить ли, если DiDi так и не пришлёт код?

Нет. Активация, по которой SMS не пришло за 20 минут, или отменённая вами возвращается на баланс полностью.

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

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

Можно ли протестировать интеграцию с DiDi, не тратя средства баланса?

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

Как платить за активации DiDi?

Пополните предоплаченный баланс в долларах США картой или USDT/USDC; ежемесячной платы нет, а на каждое пополнение приходит PDF-счёт. Актуальные тарифы — на странице цен.

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