Чек-лист получения SMS-кодов Bolt на номера OTP Route

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

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

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

Чек-лист перед заказом номера Bolt

Пройдитесь по пунктам, прежде чем что-либо тратить:

• Цель законна: аккаунт принадлежит вашей организации либо это тестовый аккаунт для вашего собственного продукта, и условия Bolt это допускают.
• Рынок выбран: страна номера соответствует месту, где будет работать аккаунт. Аккаунт пассажира, зарегистрированный на номер одной страны и используемый в другой, может вести себя иначе.
• API-ключ готов: Bearer-ключ с префиксом or_live_, созданный в консоли разработчика (до 10 на аккаунт).
• Вебхук-эндпоинт проверен: подписан на activation.sms_received, проверка подписи включена.
• Баланс пополнен: проверьте через GET /api/v1/balance либо запросите режим песочницы, чтобы отработать сценарий на имитированных номерах.
• Запасной вариант согласован: заранее решите, что тест делает, если код не приходит.

В каких странах есть маршруты Bolt?

Маршруты Bolt сейчас доступны в 198 странах. Среди примеров — Эстония, Латвия, Литва, Польша, Чехия, Португалия, Германия, Хорватия, Мальта, Грузия, ЮАР, Нигерия, Кения, Гана, Танзания и Уганда.

Выбирайте страну сознательно. Функции Bolt, способы оплаты и проверки при регистрации различаются по рынкам, поэтому тест в Варшаве мало что говорит о сценарии в Найроби. Наличие по странам меняется в течение дня; GET /api/v1/prices и личный кабинет показывают, что доступно сейчас.

Пошагово: API кода подтверждения Bolt

1. Подтвердите идентификатор сервиса через GET /api/v1/services; для Bolt это bolt.
2. Возьмите идентификатор страны из GET /api/v1/countries, например ee для Эстонии.
3. Прочитайте актуальную цену: GET /api/v1/prices?country=ee&service=bolt.
4. Закажите: POST /api/v1/activations с {"service": "bolt", "country": "ee"}. Сохраните идентификатор активации и возвращённый номер.
5. Введите номер в приложении Bolt на тестовом устройстве и запросите SMS.
6. Обработайте событие activation.sms_received. Проверьте X-OTPRoute-Signature: t=<unix>,v1=<hex>: вычислите HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта, отклоняйте старые метки времени и привязывайте запись к идентификатору активации, чтобы повторная доставка ничего не меняла.
7. Если вебхуки недоступны, опрашивайте GET /api/v1/activations/{id} каждые несколько секунд, с большим запасом до лимита 300 запросов в минуту.
8. Вызовите POST /api/v1/activations/{id}/cancel, если тест прекращён.

Подробности по эндпоинтам — в документации API, а проверку подписи объясняет материал защита вебхуков OTP.

Пошагово: через личный кабинет

Для одной SMS-верификации Bolt при тестировании или разовой настройки аккаунта достаточно браузера. Войдите, откройте OTP Gateway, выберите Bolt и рынок, проверьте цену и подтвердите. Скопируйте номер в приложение, запросите код и наблюдайте, как он появляется на карточке заказа до истечения 20-минутного таймера.

Диагностика: код Bolt так и не появился

Пустое окно ничего не стоит: если за 20 минут SMS не пришло или вы отменили заказ, вся сумма возвращается на баланс. Частые причины и решения:

• Bolt отклонил номер: как и многие платформы, он принимает виртуальные номера для регистрации не на каждом рынке. Если тест позволяет, попробуйте маршрут другой страны или повторите позже.
• Медленная доставка: время зависит от сервиса и маршрута, поэтому дождитесь конца окна, прежде чем отменять.
• Повторные запросы: многократное нажатие «отправить ещё раз» или заказы в цикле могут включить собственное ограничение Bolt. Делайте паузы между попытками.
• Не тот рынок: номер из страны, где Bolt в вашем сценарии не работает, может никогда не быть принят.

Выбор запасных вариантов разобран в руководстве по маршрутизации OTP по странам.

Когда лучше подойдёт Dedicated Number?

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

Ответственное использование номеров с Bolt

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

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

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

Да. Закажите номер для сервиса bolt в нужной стране, введите его в приложении и прочитайте код в кабинете или через API.

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

bolt. Сочетайте его с идентификатором страны вроде pl или ke при вызове POST /api/v1/activations.

Сколько стоит номер для верификации Bolt?

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

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

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

Какую страну выбрать для теста Bolt?

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

Можно ли оставить тот же номер для будущих входов в Bolt?

Не с одноразовой активацией. Для повторных входов вариант по самообслуживанию — Dedicated Number в США или Канаде.

Можно ли протестировать сценарий до оплаты?

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

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