Проверка телефонной верификации в Бурунди без местной SIM-карты

Почему так сложно проверить регистрацию по +257 из другой страны?

Представьте продуктовую команду, которая добавляет Бурунди в запуск в Восточной Африке. На экране регистрации просят номер телефона, бэкенд отправляет одноразовый код, а местной SIM-карты ни у кого нет. Роуминговые SIM-карты, купленные в поездке, со временем перестают работать, а просить коллегу из Бужумбуры зачитывать коды вслух значит раскрывать личный номер, и к тому же такой способ не встроить в ночной прогон тестов.

OTP-маршрутизация убирает это узкое место. Вместо физического телефона вы заказываете номер для верификации в Бурунди под конкретный сервис, код принимает OTP Route, а ваш тестовый стенд читает его как любое другое событие. Тот же подход подходит операционным сотрудникам, которые ведут бизнес-профили на бурундийских маршрутах и не хотят задействовать собственные телефоны.

Какие сервисы сегодня могут верифицироваться на номере из Бурунди?

В актуальном снимке по Бурунди есть знакомые мессенджеры, поисковые и коммерческие приложения, в том числе WhatsApp, Viber, imo, Telegram, Signal, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, ChatGPT (OpenAI), Uber и Amazon. Всего маршрут охватывает более 1000 сервисов.

Состав меняется в течение дня, поэтому считайте этот список отправной точкой, а не обещанием. Ваш код должен запрашивать актуальную картину через GET /api/v1/services и GET /api/v1/countries, а полный каталог можно просмотреть в разделе страны.

Как OTP API для Бурунди вписывается в тестовый прогон?

Создайте ключ в консоли разработчика; боевые ключи начинаются с or_live_ и передаются в заголовке Bearer по адресу https://otproute.com/api/v1. Типичная автоматическая проверка выглядит так:

1. Вызовите GET /api/v1/prices?country=bi&service=whatsapp, чтобы узнать текущую цену для этой пары.
2. Отправьте POST /api/v1/activations с телом {"service": "whatsapp", "country": "bi"}. В ответе придут идентификатор активации и номер +257, который нужно ввести в тестируемое приложение.
3. Дождитесь вебхука activation.sms_received или опрашивайте GET /api/v1/activations/{id} с разумным интервалом.
4. Проверьте код в ассерте и завершите тест.

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

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

В Бурунди закрытый план нумерации: абонентский номер состоит из восьми цифр после кода страны, а префикса для внутренних звонков, который нужно отбрасывать, нет. В формате E.164 это +257 и восемь цифр без пробелов. В формах номер часто отображают парами цифр, поэтому при вводе удаляйте пробелы, дефисы и ведущий 00 до сохранения.

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

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

Код не пришёл: что делать?

Каждая активация остаётся открытой 20 минут. Если за это время SMS не поступило на номер или вы отменили активацию через POST /api/v1/activations/{id}/cancel, вся сумма автоматически возвращается на ваш кошелёк.

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

Удобнее работать в панели? Войдите, выберите Бурунди и сервис, скопируйте номер в приложение и следите, как код появляется на экране. Другие приёмы собраны в материале о снижении числа неудачных доставок OTP.

Можно ли сохранить бурундийскую линию для аккаунтов, в которые мы входим регулярно?

В режиме самообслуживания нельзя. OTP Route не продаёт долгосрочные номера Бурунди: OTP Gateway выдаёт один номер на одну верификацию. Если команде действительно нужна постоянная линия там, напишите на [email protected] и опишите задачу; доступность зависит от местных правил и не гарантируется.

Dedicated Virtual Numbers (выделенные виртуальные номера) существуют только в США и Канаде, от $1.95/месяц, с входящими SMS, пересылкой на вебхук и звонками из браузера. Если для ваших стейджинг-аккаунтов подойдёт американская или канадская линия, посмотрите раздел виртуальные номера.

Как тарифицируется использование для Бурунди?

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

Используйте каждый номер только для собственного продукта или легитимных бизнес-аккаунтов, соблюдайте условия каждого сервиса и помните, что действует политика допустимого использования OTP Route. Актуальные расценки — на странице тарифов.

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

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

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

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

Передавайте bi в качестве значения country, например в POST /api/v1/activations вместе с идентификатором сервиса, таким как telegram.

Спишутся ли деньги, если код +257 так и не придёт?

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

Нужно ли убирать ведущий ноль у бурундийских номеров?

Нет. В Бурунди нет префикса для внутренних звонков, поэтому форма E.164 — это просто +257 и восемь цифр.

На каком языке придёт SMS с кодом из Бурунди?

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

Можно ли использовать тот же номер Бурунди в следующем месяце?

Нет. Номера Gateway рассчитаны на одну верификацию. Для повторных входов есть Dedicated Number, но только в США и Канаде.

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

Цены для Бурунди начинаются от $0.20 за код, точная сумма зависит от сервиса. Её возвращает GET /api/v1/prices, и она показывается до оформления заказа.

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