SMS-верификация в Монтсеррате для разработчиков и QA-команд

Зачем команде вообще нужен номер Монтсеррата?

Монтсеррат — британская заморская территория в восточной части Карибского моря, официальный язык — английский. Это небольшой рынок, но полезный пограничный случай. Его номера входят в Североамериканский план нумерации с кодом региона 664, поэтому начинаются с +1, как американские, хотя принадлежат другому региону. Команды, которые запускаются по всему Карибскому бассейну или поддерживают валидатор телефонов, используют линию Монтсеррата, чтобы убедиться, что их код учитывает это различие.

Типичные цели: проверить, что в форме регистрации в списке стран есть Монтсеррат, что английские SMS-шаблоны и тексты согласия естественно читаются для пользователей из Карибского региона и что правила анти-фрода не помечают добросовестного пользователя только потому, что этот регион редко встречается в вашем трафике.

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

Храните их в формате E.164: +1664 и семизначный локальный абонентский номер, всего десять цифр после «+1». Магистрального нуля, который нужно убирать, здесь нет. Сохраняйте рядом с номером код региона ISO MS, потому что определение страны по префиксу +1 запишет пользователя из Монтсеррата в США. Статья о маршрутизации OTP по странам объясняет, почему данные о регионе важны на следующих этапах.

Пользователи в рамках этого плана нумерации часто набирают ведущую единицу перед кодом региона или вовсе опускают знак «+». Принимайте такой ввод, нормализуйте его на сервере до значения E.164 и применяйте то же правило в тестовых фикстурах, чтобы номер Монтсеррата на стейджинге вёл себя точно так же, как в продакшене.

Какие сервисы могут отправить код на номер Монтсеррата?

Актуальный срез для ms включает WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Snapchat, Discord, Amazon, Netflix, Signal и Viber; всего на маршруте более 500 сервисов. Наличие на маршруте небольшого острова может быстро меняться, поэтому перед каждым запуском запрашивайте доступность, а не полагайтесь на то, что вчерашние пары всё ещё работают.

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

Создайте активацию через POST /api/v1/activations с телом {"service": "<id>", "country": "ms"}, используя Bearer-ключ с префиксом or_live_. Подставьте полученный номер в форму регистрации. Когда код придёт, на ваш вебхук поступит подписанное событие activation.sms_received; проверьте HMAC в X-OTPRoute-Signature и отбрасывайте устаревшие метки времени. Если публичного эндпоинта нет, опрашивайте GET /api/v1/activations/{id}. Если окно истечёт, вы получите activation.expired, а ручная остановка через POST /api/v1/activations/{id}/cancel породит activation.cancelled. Привяжите обработчик к идентификатору активации, чтобы повторно доставленное событие обрабатывалось один раз. Подробности — на странице OTP Gateway.

Можно ли обойтись личным кабинетом?

Да. Войдите, пополните баланс, выберите сервис, укажите Монтсеррат и скопируйте номер. Когда код придёт, он появится в активации в пределах 20-минутного окна. Сотрудникам операционных отделов, которые проверяют отдельный сценарий вручную, обычно больше ничего не нужно. Тестировщик, подтверждающий одну регистрацию вручную, может работать в браузере от начала до конца и вообще не создавать API-ключ.

Что должен покрывать тест-кейс для Монтсеррата?

• Номер принимается формой и сохраняется с регионом MS, а не US.
• Проверочное SMS, которое отправляет ваш собственный продукт, корректно отображается на английском.
• Кнопки повтора и повторной отправки ведут себя разумно, когда код задерживается.
• Системы аналитики и биллинга относят пользователя к правильной территории.
• Текст ошибки понятен, когда приложение отклоняет номер.

Что делать, если сегодня для моего приложения нет маршрута в Монтсеррате?

Повторите позже: доступность меняется в течение дня. Если для теста нужен лишь карибский номер +1, практичной заменой может стать соседний маршрут, например Ангилья. Не заказывайте номера повторно в быстром цикле: делайте паузы между попытками и дожидайтесь закрытия каждого окна.

Как устроены оплата и долгосрочные линии?

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

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

Можно ли получать SMS с OTP из Монтсеррата, не находясь на острове?

Да. OTP Route выдаёт временный номер +1 664, которым можно пользоваться откуда угодно, а код показывается в кабинете или приходит через API.

Какой идентификатор страны у Монтсеррата в API?

Используйте ms в поле country при создании активации или запросе цен.

Как долго открыта активация для Монтсеррата?

Двадцать минут. За это время номер получает один код, после чего заказ закрывается.

Взимается ли плата, если код не пришёл?

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

Почему мой валидатор считает номер +1 664 американским?

Потому что он смотрит только на код страны. Проверяйте код региона и сохраняйте регион MS, чтобы пользователи из Монтсеррата классифицировались правильно.

Некоторые приложения отклоняют мой номер Монтсеррата. Почему?

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

Есть ли песочница для разработки интеграции?

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

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

Цена начинается от $0.20 за код; точная цена зависит от сервиса и возвращается запросом GET /api/v1/prices.

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