Как перехватывать OTP Careem через номер с API-доступом

Какова последовательность вызовов API для кода подтверждения Careem?

Все запросы идут на https://otproute.com/api/v1 с Bearer-ключом (префикс or_live_) из консоли разработчика. Для Careem схема короткая:

1. GET /api/v1/prices?country=ae&service=careem возвращает актуальную цену номера ОАЭ; для другого рынка просто подставьте его идентификатор страны.
2. POST /api/v1/activations с телом {"service": "careem", "country": "ae"} возвращает идентификатор активации и номер.
3. Ваше тестовое устройство или эмулятор вводит этот номер на экране телефона в Careem.
4. Код приходит через вебхук или запрос опроса, и ваш скрипт его отправляет.
5. POST /api/v1/activations/{id}/cancel освобождает активацию, если прогон прервался до того, как понадобился код.

Лимиты аккаунта — 10 API-ключей, 5 вебхук-эндпоинтов и 300 запросов в минуту, этого с запасом хватает для параллельной матрицы тестов. Справочник по эндпоинтам находится в документации.

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

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

Сделайте обработчик идемпотентным: ключом записи должен быть идентификатор активации, чтобы повторная доставка не отправила код дважды. Отвечайте 2xx быстро, а тяжёлую работу передавайте в очередь.

Опрос — более простая альтернатива для одного теста: вызывайте GET /api/v1/activations/{id} каждые несколько секунд, пока не появится код или активация не сообщит, что истекла.

Когда Careem запрашивает номер телефона?

Careem — приложение для заказа поездок и повседневных сервисов из Дубая, наиболее известное в странах Персидского залива, на всём Ближнем Востоке и в Пакистане. Как и большинство подобных приложений, оно считает мобильный номер главным идентификатором аккаунта: код обычно отправляется при регистрации, а также при входе с нового устройства или восстановлении доступа. Водители и поддержка тоже связываются с пассажиром по этому номеру во время поездки.

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

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

Маршрут Careem сейчас охватывает 197 стран, но практический выбор — рынок, которому принадлежит ваш аккаунт или тест-кейс. Профиль пассажира в Эр-Рияде должен иметь саудовский номер, а тест онбординга для Карачи или Лахора относится к пакистанскому. Часто используемые варианты:

• Объединённые Арабские Эмираты (ae) и Саудовская Аравия (sa)
• Пакистан, Иордания, Катар и Египет
• Кувейт, Бахрейн, Оман и Марокко для других региональных сценариев
• Турция, Великобритания, Индия и Кения для сценариев с путешественниками и диаспорой

В статье о маршрутизации по странам объясняется, как выбрать запасной вариант, если в первой стране закончились номера.

Как получить код Careem из панели?

Откройте OTP Gateway, выберите Careem в качестве сервиса и нужную страну и проверьте указанную цену. Закажите номер, введите его в приложении Careem и оставьте карточку активации открытой: код появится там, когда придёт. Номер действует для одного кода.

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

Careem может отклонять виртуальные номера в зависимости от собственных проверок риска и менять это поведение без предупреждения. Именно поэтому существует возврат: если SMS не пришло в течение 20 минут или вы отменили активацию, деньги автоматически возвращаются в кошелёк.

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

Стоит ли для постоянного входа в Careem использовать Dedicated Number?

Номер OTP Gateway принимает один код. Если бизнес-аккаунту Careem или долгоживущему тестовому профилю нужно входить снова через несколько недель, Dedicated Number сохраняет тот же номер, пока продлевается. Такие номера доступны мгновенно только в США и Канаде, от $1.95 в месяц, с входящими SMS в панели и через вебхук number.sms_received. См. виртуальные номера.

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

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

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

Идентификатор сервиса — careem. Сочетайте его с идентификатором страны, например {"service": "careem", "country": "sa"}.

Можно ли получить OTP от Careem без SIM-карты из стран Залива?

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

Принимает ли Careem виртуальные номера?

Не всегда. Это решает сам Careem, поэтому активации без SMS возвращаются автоматически.

Сколько стоит виртуальный номер для Careem?

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

Что выбрать для тестирования SMS-верификации Careem — опрос или вебхуки?

Для одного ручного прогона достаточно опроса. Для параллельных CI-задач лучше масштабируется подписанный вебхук с идемпотентным обработчиком.

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

Только с Dedicated Number — это продукт для США и Канады. Номера OTP Gateway рассчитаны на один код подтверждения.

Можно ли создавать через OTP Route несколько аккаунтов пассажиров Careem?

Нет. Используйте сервис для собственного тестирования и легитимных бизнес-аккаунтов и придерживайтесь правила один аккаунт на реального человека или компанию по условиям Careem.

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