Как получить коды подтверждения +975 из Бутана в вашем наборе тестов

Зачем продуктовой команде бутанский номер?

Бутан — небольшой рынок, но в планах он встречается чаще, чем принято думать: сценарии бронирования для туристов и гостиничного бизнеса, платёжные и денежно-переводные приложения для бутанских семей, у которых родственники учатся или работают за границей, а также региональные приложения, запускаемые сразу по всей Южной Азии. QA-инженер, которому нужно доказать, что регистрация с номером +975 действительно завершается, не справится с этим с домашней SIM-картой.

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

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

Какие приложения могут отправлять коды на маршрут +975?

Актуальный список Бутана сейчас включает более 1 700 сервисов. Часто запрашиваются WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, Viber, WeChat, Microsoft & Outlook, Amazon, Airbnb и Uber.

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

В каком порядке вызывать API для идентификатора страны `bt`?

1. Авторизуйтесь Bearer-ключом (префикс or_live_), созданным в консоли разработчика, по адресу https://otproute.com/api/v1.
2. Запросите актуальную цену этой пары через GET /api/v1/prices?country=bt&service=<id>.
3. Закажите номер через POST /api/v1/activations с телом {"service": "<id>", "country": "bt"}.
4. Либо опрашивайте GET /api/v1/activations/{id}, либо подпишитесь на activation.sms_received, activation.expired и activation.cancelled.
5. Освободите ненужный номер через POST /api/v1/activations/{id}/cancel.

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

На аккаунте можно держать до 10 API-ключей и 5 эндпоинтов вебхуков и отправлять 300 запросов в минуту, чего более чем достаточно для ночного регрессионного прогона на таком небольшом рынке. При более редком ритме цикл опроса раз в несколько секунд сводит число подвижных частей к минимуму.

Как хранить номера +975?

Держите одну каноническую форму: +975 и национальные цифры без пробелов, дефисов и скобок. Мобильные номера Бутана состоят из восьми цифр, то есть короче десятизначного шаблона, который предполагают многие валидаторы, поэтому ослабьте любую проверку длины, настроенную под более крупные рынки. Если пользователь по привычке ввёл ведущий ноль, удалите его перед сохранением. Нормализация на границе системы делает согласованными дедупликацию, антифрод-правила и поиск в поддержке.

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

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

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

Номер, на который ничего не пришло, ничего не стоит, потому что возврат автоматический. Больше приёмов — в материале как снизить число неудачных доставок OTP.

Полезно также записывать идентификатор активации рядом с идентификатором вашего тестового прогона: тогда пропавший код можно отследить за секунды, а не гадать.

Долгосрочные линии, оплата и песочница

В OTP Route нет самостоятельного оформления долгосрочного номера в Бутане. Выделенные линии — продукт для США и Канады от $1.95 в месяц; по бутанской линии можно написать на [email protected], но возможность зависит от местных правил. Всё работает на предоплаченном кошельке в долларах США без ежемесячной платы, который пополняется картой или USDT/USDC, и за каждое пополнение выдаётся PDF-счёт. Тестовые аккаунты могут запросить режим песочницы, чтобы отрепетировать весь сценарий bt с имитированными номерами. Как работает кошелёк, читайте на странице тарифов.

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

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

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

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

Бутан — это bt. Передавайте его в запросе цен и в теле запроса активации.

Сколько стоит один код подтверждения для Бутана?

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

На каком языке обычно приходят OTP-сообщения в Бутане?

В основном на английском, который распространён в бутанском бизнесе и образовании. Национальный язык — дзонг-кэ, поэтому если вы отправляете сообщения на нём, протестируйте свои локализованные шаблоны.

Спишут ли деньги, если на номер +975 ничего не придёт?

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

Можно ли оставить номер Бутана для повторных входов?

Самостоятельно — нет. Долгосрочные номера предлагаются только в США и Канаде; по Бутану можно написать команде по почте и уточнить.

Допустимо ли создавать множество аккаунтов с номерами Бутана?

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

Какие способы оплаты принимает кошелёк?

Карты и стейблкоины USDT или USDC. Вы платите только за использованное, и выбирать тариф не нужно.

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