Тестируем регистрацию по +236, когда ни у кого в команде нет центральноафриканской SIM-карты

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

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

Сервис OTP-маршрутизации вроде OTP Route закрывает этот пробел, и его OTP API для ЦАР — тот же, что и для любой другой страны. Вместо пересылки оборудования вы запрашиваете линию +236 вызовом API, вводите её на собственном экране регистрации и считываете код программно. Тот же запрос работает в сеансе на ноутбуке, в ночном регрессионном задании или во вкладке браузера у инженера поддержки, и труднодоступный рынок становится обычной строкой вашей тестовой матрицы.

Какие сервисы сегодня могут получать SMS-коды из ЦАР?

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

Наличие меняется в течение дня, поскольку наши операторы-партнёры обновляют ёмкости, поэтому считайте любой список на веб-странице отправной точкой, а не обещанием. Перед каждым прогоном запрашивайте у GET /api/v1/prices?country=cf&service=<id> текущую цену и признак того, открыт ли маршрут. Некоторые приложения из каталога вообще отказываются от виртуальных линий; это решение самого приложения, а не сети, и именно поэтому заказы без ответа возвращаются.

Как бэкенд запрашивает номер +236 для тестирования?

Всё находится по адресу https://otproute.com/api/v1 и аутентифицируется Bearer-ключом с префиксом or_live_, выданным в консоли разработчика. Минимальный сеанс API для SMS-верификации выглядит так:

1. Один раз найдите идентификаторы через GET /api/v1/services и GET /api/v1/countries; Центральноафриканская Республика — это cf.
2. Проверьте цену и доступность через GET /api/v1/prices.
3. Создайте заказ через POST /api/v1/activations с телом вида {"service": "viber", "country": "cf"}.
4. Подайте возвращённый номер +236 на тестируемый экран.
5. Получите код через вебхук activation.sms_received или опрашивайте GET /api/v1/activations/{id} раз в несколько секунд.
6. Если тест прерван, освободите линию через POST /api/v1/activations/{id}/cancel.

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

Что нужно знать о центральноафриканских номерах и языке сообщений?

Номера в Центральноафриканской Республике подчиняются закрытому плану из восьми цифр без префикса для внутренних звонков, поэтому внутренняя и международная формы отличаются лишь кодом страны. Храните каждое значение в формате E.164, например +236 и восемь местных цифр, а пробелы и дефисы удаляйте при вводе. Валидация, которая требует ведущий ноль или десять цифр, молча отклонит настоящих пользователей.

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

Может ли сотрудник без навыков разработки получить номер верификации в ЦАР?

Да. Продакт-менеджеры, руководители поддержки и сотрудники агентств могут сделать всё из браузера:

• Создайте аккаунт с кодом из письма или через вход Google и включите двухфакторную защиту TOTP.
• Откройте OTP Gateway, выберите сервис и укажите Центральноафриканскую Республику.
• Проверьте показанную перед заказом цену и подтвердите.
• Вставьте номер +236 в приложение и дождитесь появления кода на экране.

Активация остаётся открытой 20 минут. Платить нужно только если код пришёл; отмените активацию или дайте окну закрыться, и вся сумма вернётся на кошелёк.

Что делать, если код так и не появляется на линии +236?

Молчащий номер обычно означает, что приложение ограничило запрос, отказало виртуальной линии или маршрут был занят. Разберитесь спокойно:

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

Больше приёмов собрано в материале о снижении числа неудачных доставок OTP.

Есть ли долгосрочная линия +236 и как тарифицируется использование?

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

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

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

Как получать SMS-коды из Центральноафриканской Республики без местной SIM-карты?

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

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

cf. Используйте его в запросе цен и в теле активации.

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

Коды начинаются от $0.20 за штуку, точная сумма зависит от сервиса. Актуальную цену маршрута +236 можно увидеть в панели и в эндпоинте цен до заказа.

Спишутся ли деньги за заказ +236, если проверочное SMS не дойдёт?

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

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

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

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

В режиме самообслуживания нет. Каждый номер OTP Gateway рассчитан на один код, а долгосрочные линии — продукт для США и Канады; о других вариантах можно спросить в поддержке по почте.

Можно ли протестировать интеграцию бесплатно?

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

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