Тестируем регистрацию на +226: чек-лист по номеру для верификации в Буркина-Фасо

Что нужно подготовить, прежде чем запрашивать номер +226?

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

• API-ключ. Создайте его в консоли разработчика; боевые ключи начинаются с префикса or_live_ и передаются как Bearer-токен. Всего можно держать до 10 ключей, так что выделите отдельные для стейджинга и CI.
• Пополненный кошелёк. Пополнение картой или стейблкоинами USDT/USDC. За код, который так и не пришёл, ничего не списывается.
• Правильные идентификаторы. В API Буркина-Фасо обозначается как bf. Идентификатор сервиса берите через GET /api/v1/services, а не угадывайте.
• План доставки. Либо вебхук с надёжно сохранённым секретом, либо цикл опроса с разумными паузами. На аккаунт можно зарегистрировать до 5 вебхук-эндпоинтов, удобно разделять стейджинг и продакшен.
• Легитимный аккаунт для подтверждения. Тестовый пользователь вашего продукта или бизнес-аккаунт, которым управляет ваша команда. Действуют условия каждого сервиса и политика допустимого использования OTP Route.

Все поля описаны в справочнике API, если хочется заглянуть в него до написания кода.

Какие приложения могут присылать коды на маршрут Буркина-Фасо?

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

Доступность меняется в течение дня, поскольку наши операторы-партнёры то добавляют, то выводят мощности, поэтому воспринимайте этот список как снимок. Перед каждым заказом ваш код должен обращаться к GET /api/v1/prices: в ответе будет текущая цена и признак того, можно ли вообще заказать эту пару.

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

1. Узнайте цену для своей пары через GET /api/v1/prices?country=bf&service=whatsapp (подставьте свой идентификатор сервиса).
2. Создайте активацию через POST /api/v1/activations с телом {"service": "whatsapp", "country": "bf"}. Сохраните возвращённый идентификатор активации: все дальнейшие события привязаны к нему.
3. Запустите отправку SMS из тестируемого приложения, указав номер +226 из ответа.
4. Дождитесь события activation.sms_received на вебхуке. Проверьте заголовок X-OTPRoute-Signature формата t=<unix>,v1=<hex>: вычислите HMAC-SHA256 от "<t>.<raw body>" с секретом эндпоинта, сравните и отбрасывайте запросы с устаревшей меткой времени. Разбор нюансов есть в материале о защите вебхуков OTP с помощью HMAC.
5. Вебхука нет? Опрашивайте GET /api/v1/activations/{id} раз в несколько секунд.
6. Закончили раньше или проверяете сценарий сбоя? Вызовите POST /api/v1/activations/{id}/cancel. Если запуск закончился без кода, вы также увидите activation.expired или activation.cancelled.

Лимит аккаунта составляет 300 запросов в минуту: для опроса этого с запасом, если каждый запуск делает небольшие паузы.

Может ли заказать код +226 человек, который не пишет код?

Да. Сотрудники поддержки, маркетологи и менеджеры по работе с клиентами могут сделать то же самое вручную. Войдите в аккаунт, откройте OTP Gateway, выберите Буркина-Фасо, укажите сервис и подтвердите цену на экране. Номер появится сразу: вставьте его в приложение, запросите SMS, и код отобразится в той же строке панели. Вкладку можно оставить открытой или вернуться позже: активация слушает входящие сообщения все свои 20 минут.

Как хранить номера +226 и на каком языке придёт SMS?

В Буркина-Фасо национальные номера состоят из восьми цифр, а префикса для внутренних звонков нет, поэтому ведущий ноль убирать не нужно: национальная форма совпадает с цифрами после +226. Храните номера в формате E.164 как +226 и восемь цифр, а пользовательский ввод нормализуйте: удаляйте пробелы, дефисы и международный префикс 00 до сохранения. Правила валидации, скопированные с рынков с «нулевым» префиксом, будут отклонять корректные номера +226. Это классическая ошибка локализации, под которую стоит завести регрессионный тест.

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

Команды обычно тестируют этот маршрут при запуске во франкоязычной Западной Африке, при проверке французских текстов на экране регистрации или при подключении клиентов платёжных и мобильных денежных продуктов. Такой сценарий описан на странице онбординга в финтехе.

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

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

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

Есть ли долгосрочный номер для Буркина-Фасо и как устроена оплата?

Самостоятельно оформить долгосрочную линию +226 нельзя. Dedicated Numbers (выделенные номера) — это продукт для США и Канады, от $1.95/месяц, с входящими и исходящими SMS и звонками из браузера. Если вам нужна постоянная линия в Буркина-Фасо, напишите на [email protected]; возможность зависит от местных правил и не гарантируется.

Оплата активаций +226 списывается с единого предоплаченного кошелька в долларах США, без подписки и выбора тарифа. Каждое пополнение картой или USDT/USDC сопровождается PDF-счётом на почту. Для интеграционных работ попросите перевести тестовый аккаунт в режим песочницы: он выдаёт имитированные номера и коды, и тесты не тратят реальные средства. Актуальные расценки — на странице тарифов.

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

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

Да. Закажите номер +226 в OTP Gateway, запустите отправку SMS из своего приложения и прочитайте код в панели или через API. Платить нужно только если код пришёл.

Какой идентификатор страны для Буркина-Фасо в API OTP Route?

bf. Используйте его вместе с идентификатором сервиса из GET /api/v1/services при обращении к эндпоинтам цен и активаций.

Начинаются ли номера +226 с нуля?

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

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

Двадцать минут на одну активацию. Если окно закрылось без SMS или вы отменили активацию, вся сумма автоматически возвращается на кошелёк.

Придёт ли код на французском?

Это зависит от отправляющего сервиса и языка, выбранного в аккаунте. Чаще всего встречаются французский и английский, поэтому проверяйте оба, если продукт их поддерживает.

Можно ли использовать номер +226 для массового создания аккаунтов на одной платформе?

Нет. OTP Route предназначен для тестирования вашего собственного продукта и работы с легитимными бизнес-аккаунтами. Массовые регистрации и вымышленные личности нарушают политику допустимого использования и условия самой платформы.

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