Проверяем регистрацию с номерами +387, когда ни у кого в команде нет боснийской SIM-карты

Релизу нужен тест с номером +387, а SIM-карта лежит в ящике в Сараеве. Что делать?

Знакомая проблема для команд, выпускающих продукт на Западных Балканах. Продакт-менеджер хочет доказательство, что боснийские пользователи могут зарегистрироваться, в чек-листе QA-лида есть пункт «проверить с местным номером», а единственная физическая SIM-карта +387 принадлежит коллеге, ушедшему прошлой весной.

Обычные причины, по которым команды оказываются в такой ситуации:

• Региональный запуск, охватывающий Боснию и Герцеговину наряду с Хорватией, Сербией и Черногорией, где путь регистрации на каждом рынке требует отдельной проверки.
• Диаспора. Многие жители Германии, Австрии, Швеции и других стран по-прежнему сохраняют номер +387, поэтому финтех- или околотелеком-продукт может получать боснийские номера от пользователей, которые во время регистрации ни разу не были в стране.
• QA локализации. Боснийский, хорватский и сербский — официальные языки, а в повседневной жизни встречаются и латиница, и кириллица, так что тексты и валидация форм заслуживают настоящей сквозной проверки.

Вместо рассылки SIM-карт по почте OTP-маршрутизацию берёт на себя OTP Route: OTP Gateway выдаёт номер +387 для одной верификации и возвращает входящее SMS через API SMS-верификации, который может вызывать ваш тестовый стенд.

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

Покрытие — это живой срез, поэтому считайте список отправной точкой, а не фиксированным меню. На момент написания маршруты Боснии и Герцеговины включают Viber, WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, Microsoft & Outlook, LinkedIn, Discord, Uber, Amazon и eBay.

Всего для страны доступно более 1 600 сервисов. Если вам нужен номер Боснии и Герцеговины для сервиса, которого здесь нет, сначала проверьте актуальный список. Viber на Балканах важнее, чем во многих других регионах, и об этом стоит помнить, если ваш собственный продукт отправляет коды не только по SMS, но и через мессенджеры. Поскольку доступность меняется в течение дня, запрашивайте у API текущие варианты, а не прописывайте список в тестовом наборе.

Как выглядит сценарий OTP API для Боснии и Герцеговины, вызов за вызовом?

Для боснийских тестов направьте клиент на https://otproute.com/api/v1 и передавайте ключ or_live_ как Bearer-токен. Ключи создаются в консоли разработчика; на аккаунте можно держать до 10 ключей и 5 эндпоинтов вебхуков, а предел — 300 запросов в минуту.

1. Один раз вызовите GET /api/v1/services и GET /api/v1/countries, закэшируйте идентификаторы и убедитесь, что ba есть в списке.
2. Проверьте стоимость через GET /api/v1/prices?country=ba&service=<id>, чтобы задание записало точную сумму до траты.
3. Отправьте POST /api/v1/activations с {"service": "<id>", "country": "ba"}. В ответе придут идентификатор активации и номер +387, который нужно ввести в тестируемом приложении.
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 от <t>.<raw body> с секретом эндпоинта, сравнивайте за постоянное время и отбрасывайте устаревшие метки времени. Так как события привязаны к идентификатору активации, код +387, доставленный дважды, должен записываться только один раз. В руководстве по интеграции OTP API подробнее разобраны повторные попытки и обработка ошибок.

Есть ли способ без кода для поддержки или операционной команды?

Да. Сотрудник без доступа к API может сделать то же самое из браузера: войти, открыть OTP Gateway, выбрать Боснию и Герцеговину и сервис, посмотреть цену и подтвердить. Номер появится на экране, а код отобразится рядом, когда придёт SMS. Это подходит агенту поддержки, воспроизводящему проблему клиента с регистрацией, или руководителю операций, проверяющему партнёрский портал после смены телефона.

Как хранить номера +387 и разбирать текст боснийских SMS?

Внутри страны боснийские номера набираются с префиксом 0, а мобильные обычно начинаются с 06. В E.164 этот ноль исчезает: номер, записанный локально как 061 и ещё шесть цифр, превращается в +387 61 и эти шесть цифр. Храните только форму E.164, удаляйте при вводе пробелы, дефисы и косые черты и отклоняйте всё, что после кода страны всё ещё содержит ведущий ноль.

Проверочные сообщения могут приходить на английском или на одном из местных языков, а текст на кириллице вполне возможен. Извлекайте код по шаблону из цифр, а не по поиску конкретного слова, и следите, чтобы ваши логи сохраняли UTF-8 без потерь, иначе диакритика вроде č, ć, š и ž будет искажена при отладке неудачного прогона.

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

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

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

Материал как снизить число неудачных доставок OTP описывает приёмы, которые обычно помогают.

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

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

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

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

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

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

Какой идентификатор использует OTP Route для Боснии и Герцеговины?

Идентификатор — ba. Передавайте его в поле country при создании активации и в параметре запроса country при проверке цен.

Плачу ли я, если код на +387 так и не пришёл?

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

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

Нет. Сохраняйте номера в E.164, то есть +387 и номер без внутреннего нуля.

Подходит ли номер +387 для тестов, если в аккаунт нужно будет войти снова в следующем месяце?

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

Можно ли запускать боснийские OTP-тесты в CI, не тратя деньги?

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

Есть ли правила использования этих номеров?

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

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