Тестируем телефонную верификацию в Уганде на реальных маршрутах +256

Почему Уганде стоит посвятить отдельный тестовый прогон?

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

Важен и региональный контекст. Продукты, выходящие на рынок Восточной Африки, часто запускаются в Кении, Танзании и Руанде вместе с Угандой, а у каждой страны свои форматы номеров и доступность сервисов. Отдельное тестирование каждой на реальных маршрутах находит проблемы, которые пропускает проверка одной страны. О том, как команды организуют такую работу, читайте в разделе про онбординг в финтехе.

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

В Уганде используется транковый префикс 0. Мобильные номера обычно пишут локально как 07 и ещё восемь цифр; в международном виде 0 исчезает, остаются +2567 и ещё восемь цифр — всего девять цифр после кода страны.

• Принимайте локальный ввод с ведущим 0 и преобразуйте его в E.164 перед сохранением.
• Следите за пользователями, которые набирают и код страны, и 0 (+2560…): удалите 0, а не отклоняйте ввод.
• Держите один канонический столбец, чтобы поиск дубликатов и логин работали корректно.

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

Какие сервисы можно подтвердить на номере +256?

У Уганды один из самых широких каталогов: сейчас маршруты есть более чем у 1 600 сервисов. Популярны WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Uber, Amazon, LinkedIn, Snapchat, Discord и ChatGPT (OpenAI). Список — это живой снимок. Проверяйте маршрут через эндпоинт цен именно в тот момент, когда он вам нужен.

Как проходит заказ через OTP API для Уганды от начала до конца?

Отправляйте запросы на https://otproute.com/api/v1 с Bearer-ключом API, который начинается с or_live_. Id страны для Уганды — ug.

1. Узнайте цену и доступность: GET /api/v1/prices?country=ug&service=<id>.
2. Создайте активацию: POST /api/v1/activations с телом {"service": "whatsapp", "country": "ug"}.
3. Введите полученный номер в тестируемое приложение и запросите код.
4. Получите его из вебхука activation.sms_received или опросите GET /api/v1/activations/{id}.
5. Прогон прерван? POST /api/v1/activations/{id}/cancel сразу вернёт средства.

Заголовок X-OTPRoute-Signature (t=<unix>,v1=<hex>) — это HMAC-SHA256 от метки времени, точки и сырого тела с секретом вашего эндпоинта в качестве ключа. Проверяйте его, отклоняйте устаревшие метки времени и делайте обработчик идемпотентным по id активации. Планируйте угандийские тестовые наборы с учётом лимитов аккаунта: 10 ключей, 5 вебхук-эндпоинтов, 300 запросов в минуту. Полный справочник — в документации для разработчиков.

Хотите кликать? В панели выберите Уганду и сервис, подтвердите актуальную цену, и код появится в заказе, как только придёт.

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

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

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

Нужна ли мне вместо этого долгосрочная угандийская линия?

Только если один и тот же аккаунт должен получать коды многократно. OTP Route продаёт Dedicated Numbers (выделенные номера) мгновенно в США и Канаде, от $1.95/месяц, с входящими и исходящими SMS, пересылкой на вебхук и звонками из браузера. Уганда в этот самообслуживаемый продукт не входит. Командам, которым нужна постоянная линия +256, можно написать на [email protected]; возможность зависит от местных правил и не гарантируется. Как сравниваются два продукта для угандийских проектов, рассказано в материале про временные и выделенные номера.

Как кошелёк и песочница вписываются в проект по Уганде?

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

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

Можно ли проверить регистрацию в Уганде, находясь за её пределами?

Да. Закажите номер +256 в OTP Gateway, запросите код из своего приложения или сервиса и прочитайте его в панели или через вебхук.

Как преобразовать номера, начинающиеся с 07, в международный формат?

Отбросьте ведущий 0 и добавьте +256: локальный мобильный номер станет +2567 и ещё восемь цифр.

Какой id страны использует API для Уганды?

Используйте ug, например в GET /api/v1/prices?country=ug&service=<id>.

Проверочные SMS в Уганде приходят на английском?

Обычно да, так как английский широко используется в деловых сообщениях, но язык зависит от сервиса и настроек аккаунта.

Списываются ли деньги, если код из Уганды не пришёл?

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

Можно ли тестировать рынки Восточной Африки вместе?

Да. Те же вызовы API работают для Кении, Танзании и Руанды, меняется только id страны, а доступность проверяется в реальном времени по каждому маршруту.

Подходит ли OTP Route для массовых регистраций на угандийские номера?

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

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