Как получать либерийские коды (+231) в тестовых прогонах

Зачем командам вообще номер Либерии?

Либерия — англоязычный рынок Западной Африки, поэтому он удобен как первая остановка для компаний, расширяющихся вдоль побережья: тексты редко нужно переводить, и усилия тестирования уходят на сам процесс верификации. К +231 также присматриваются, когда обслуживают либерийскую диаспору и хотят убедиться, что родственник на родине действительно сможет завершить регистрацию. Особенно финтех- и маркетплейс-продуктам нужно видеть, что местный номер проходит их проверки до запуска; общий подход описан на странице онбординга для финтеха.

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

Что можно верифицировать на маршруте +231?

В стране сейчас доступно более 1 700 сервисов. Среди типичных вариантов — WhatsApp, Facebook, TikTok, Telegram, Instagram, Google (Gmail и YouTube), Snapchat, imo, Viber, X (Twitter), LinkedIn и Microsoft и Outlook. Наличие меняется в течение дня, поэтому API возвращает актуальную доступность, а не фиксированный каталог.

Для тест-плана выпишите два-три сервиса, на которые действительно опираются ваши пользователи, и в начале прогона проверяйте каждую пару запросом цены. Мессенджер, который сегодня утром работал на +231, к вечеру может ненадолго стать недоступным, а конвейер, проверяющий заранее, падает с понятной причиной, а не по таймауту.

Какие эндпоинты вызывает интеграция для Либерии?

Всё находится под https://otproute.com/api/v1 с Bearer-ключом из консоли разработчика.

• Идентификаторы узнайте через GET /api/v1/services и GET /api/v1/countries; Либерия — lr.
• Узнайте цену пары через GET /api/v1/prices?country=lr&service=<id>.
• Создайте заказ через POST /api/v1/activations с телом {"service": "<id>", "country": "lr"}.
• Получайте activation.sms_received, activation.expired или activation.cancelled на вебхук, ориентируясь на идентификатор активации, либо опрашивайте GET /api/v1/activations/{id}.

Проверяйте X-OTPRoute-Signature в каждом вебхуке: вычислите HMAC-SHA256 от <t>.<raw body> секретом эндпоинта и отклоняйте старые метки времени. Подробности показаны в статье о безопасности вебхуков.

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

Да. В панели выберите Либерию, выберите сервис, подтвердите показанную цену и оформите заказ. Вставьте номер +231 в приложение; код появится рядом с заказом, как только будет доставлен. Скопируйте его прямо в поле кода в приложении, а если заказ больше не нужен, отмените его на том же экране, и баланс сразу вернётся.

Как форматировать и нормализовать номера +231?

Либерийские номера обычно записывают внутри страны с ведущим транковым префиксом 0. Отбросьте этот ноль и добавьте +231, чтобы получить форму E.164, которую должна хранить ваша база данных. Мобильные номера разных местных операторов имеют один и тот же код страны +231, поэтому при маршрутизации OTP ветвиться по оператору не нужно. Проверяйте номер по международной форме, а не по местной, и храните отдельную строку для отображения, если вашей поддержке привычнее местная запись. Официальный язык — английский, поэтому большинство шаблонов сервисов приходит на английском. Это упрощает извлечение кода, но всё равно ориентируйтесь на группу цифр, а не на фиксированную фразу: сервисы без предупреждения меняют формулировки.

Что делать, если либерийский код опаздывает или не приходит?

Доставка зависит от сервиса и маршрута. Если ничего не пришло:

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

Подробнее об этом — в материале о снижении числа неудачных доставок OTP.

Есть ли долгосрочная линия в Либерии и как за неё платить?

Самообслуживаемого долгосрочного номера для Либерии нет. Выделенные линии — продукт для США и Канады, от $1.95/месяц. Если вам нужна постоянная либерийская линия, напишите на [email protected]; возможность зависит от местных правил и не гарантируется. Для большинства либерийских тест-планов достаточно шлюза, ведь каждому шагу регистрации или подтверждения нужен лишь один код.

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

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

Можно ли протестировать процесс регистрации моего приложения в Либерии из-за рубежа?

Да. Закажите номер +231 в OTP Gateway и пройдите верификацию удалённо; местная SIM-карта не требуется.

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

Используйте lr в поле country запроса POST /api/v1/activations и в запросах цен.

Сколько стоит либерийский код?

Заказы для Либерии начинаются от $0.20 за код, сумма зависит от сервиса. Точная цена возвращается методом GET /api/v1/prices и показывается до оформления заказа.

Что будет с балансом, если либерийский код так и не будет доставлен?

Ничего не потеряется. Если по заказу на номер +231 SMS не пришло за 20 минут или вы его отменили, сумма автоматически и полностью возвращается на кошелёк.

Можно ли использовать тот же номер +231 на следующей неделе?

Нет. Номер шлюза рассчитан на один код верификации. Долгосрочные линии есть только в США и Канаде.

Что лучше: опрос или вебхуки?

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

Есть ли тестовый режим, не списывающий деньги с кошелька?

Да, по запросу тестовый аккаунт можно переключить в sandbox, который возвращает имитированные номера и коды.

Есть ли ограничения на то, что можно верифицировать?

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

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