Верификация пользователей из Сомали: номера +252 для QA и запуска на рынке

Чем особенно тестирование для Сомали?

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

К +252 команды обычно приходят по одной из трёх причин: запуск мобильного продукта в регионе Африканского Рога, обслуживание многочисленной сомалийской диаспоры в Северной Америке, Европе и странах Персидского залива либо региональные операции, которым нужен местный номер для бизнес-аккаунта. Сторона QA описана на странице верификации мобильных приложений.

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

Как хранить номер +252 в базе данных?

Сохраняйте форму E.164: +252 и далее национальный значимый номер. Если пользователь вводит местный формат с ведущим нулём, уберите его перед добавлением кода страны. Сохраняйте нормализованное значение один раз, проверяйте при вводе и форматируйте для отображения только на границах системы. Так поиск и дедупликация остаются надёжными, когда один и тот же клиент регистрируется из-за рубежа.

Полезно также проверить крайние случаи в поле ввода телефона: вставленный номер с пробелами, номер с международным префиксом 00252 и номер, введённый со знаком плюс. Все три должны сводиться к одному сохранённому значению, а ваша логика OTP-маршрутизации должна выбирать маршрут Сомали по этому значению, а не по IP-адресу пользователя.

Какие сервисы могут присылать коды на сомалийские номера?

На маршруте Сомали доступно более 900 сервисов. Среди популярных — WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, imo, Viber, Signal, Snapchat и Microsoft & Outlook. Поскольку наличие меняется в течение дня, узнавайте через API, что открыто прямо сейчас.

Как на практике выглядит последовательность вызовов OTP API для Сомали?

Используйте Bearer-ключ с префиксом or_live_ и адрес https://otproute.com/api/v1.

1. Получите идентификаторы через GET /api/v1/services и GET /api/v1/countries. Сомали — это so.
2. Узнайте цену: GET /api/v1/prices?country=so&service=<id>.
3. Начните заказ: POST /api/v1/activations с телом {"service": "<id>", "country": "so"}.
4. Примите обратный вызов activation.sms_received по сомалийскому заказу или проверяйте его статус опросом GET /api/v1/activations/{id}.
5. Освободите ненужный заказ через POST /api/v1/activations/{id}/cancel.

Проверяйте X-OTPRoute-Signature (HMAC-SHA256 от <t>.<raw body>) и отклоняйте запросы со старой отметкой времени. Аккаунту доступно до 10 ключей, 5 endpoint вебхуков и 300 запросов в минуту; см. документацию.

Может ли коллега из операционного отдела сделать это через панель?

Да. Откройте OTP Gateway, выберите Сомали и сервис, посмотрите цену и оформите заказ. Номер +252 появляется сразу, а код отображается рядом с ним, когда придёт. Ни код, ни API-ключ для этого пути не нужны, что подходит региональному менеджеру, настраивающему единственный бизнес-профиль, или сотруднику поддержки, воспроизводящему проблему клиента при регистрации.

Что делать, если сомалийский код не приходит?

Маршруты работают по-разному, а некоторые сервисы отклоняют виртуальные номера. Дайте 20-минутному окну завершиться: при истечении или отмене полная сумма возвращается. Затем повторите позже или попробуйте другой маршрут сервиса, а не заказывайте снова в быстром цикле. Ведите краткий журнал: какой сервис и в какое время суток использовался в каждой попытке — закономерности так заметнее, чем по памяти. Покрытие Сомали может быть уже, чем в более крупных странах, поэтому если вашему тесту нужен просто восточноафриканский номер, стоит проверить соседние маршруты — например, Кению, Эфиопию или Джибути.

Можно ли получить долгосрочную сомалийскую линию и как устроена оплата?

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

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

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

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

Да. Закажите номер +252 в OTP Gateway и прочитайте код в панели или в своём вебхуке.

Какой идентификатор страны в API у Сомали?

Это so; он используется в запросах цен и в теле POST /api/v1/activations.

Коды будут приходить на сомалийском или арабском?

Это зависит от сервиса и языка аккаунта. OTP Route доставляет текст сообщения без изменений, поэтому проверьте парсер на обеих письменностях.

Сколько стоит номер +252 для тестирования?

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

Можно ли сохранить тот же сомалийский номер для последующих входов?

Нет. Номера шлюза служат для одного кода, а самообслуживаемые долгосрочные номера предлагаются только в США и Канаде.

Связан ли OTP Route с приложениями, которые я верифицирую?

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

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