Приём гонконгских (+852) SMS с OTP для тестирования и операционной работы

Почему номера +852 легко нормализовать?

В Гонконге закрытый план нумерации: у каждого абонентского номера восемь цифр, кодов региона нет, а транковой приставки, которую нужно отбрасывать, тоже нет. Номер, который вводит местный пользователь, — это те же восемь цифр, что идут после +852 в E.164. Мобильные диапазоны обычно начинаются с 5, 6 или 9.

Цифры обычно записывают двумя группами по четыре, поэтому форма регистрации должна убирать пробелы и дефисы перед проверкой. Сохраняйте каноническую строку +852XXXXXXXX, сравнивайте по ней и форматируйте только при отображении. Поскольку длина фиксирована, простая проверка длины ловит большинство опечаток, но для проверки диапазонов держите в цепочке полноценную библиотеку для телефонных номеров.

На каких языках приходят проверочные тексты в Гонконге?

Китайский и английский оба официальные, в повседневной речи используется кантонский, а письменный китайский здесь записывается традиционными иероглифами. Сервис может отправить код на английском или традиционном китайском в зависимости от локали аккаунта, а сообщения китайским письмом передаются как Unicode-SMS.

Два практических вывода для QA. Во-первых, извлекайте код по шаблону цифр, а не по соседним словам, чтобы парсер работал с обоими шаблонами. Во-вторых, если ваш продукт сам отправляет локализованное сообщение, проверьте, что версия на традиционном китайском корректно отображается на принимающей стороне, а не только в вашем редакторе шаблонов.

Почему команды проводят тесты регистрации на гонконгском маршруте?

Гонконг — региональная база для многих компаний Азиатско-Тихоокеанского региона, а его пользователи часто держат аккаунты как в международных, так и в ориентированных на материковый Китай приложениях. Такое сочетание делает рынок полезным для проверки локализации, трансграничного онбординга и сценариев поддержки.

Актуальный срез показывает для Гонконга более 3 600 сервисов. Среди часто используемых — WhatsApp, WeChat, LINE, Signal, Alibaba, Telegram, Google (Gmail & YouTube), Facebook, Instagram, LinkedIn, Uber, Airbnb, Netflix, AliExpress и Amazon. Платёжные продукты и кошельки тоже тестируют здесь: сломанный шаг с телефоном на экране онбординга в Гонконге останавливает клиента ещё до первой транзакции. Актуальная доступность меняется в течение дня, поэтому читайте её во время выполнения.

Как выглядит поток Hong Kong OTP API со страной `hk`?

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

1. Один раз за прогон прочитайте GET /api/v1/services и GET /api/v1/countries, чтобы сопоставить названия с id.
2. Запросите GET /api/v1/prices?country=hk&service=<id>, чтобы узнать актуальную цену.
3. Отправьте POST /api/v1/activations с {"service": "wechat", "country": "hk"}.
4. Введите номер +852 в тестируемом потоке.
5. Заберите код из события activation.sms_received или, как запасной вариант, опрашивайте GET /api/v1/activations/{id} каждые несколько секунд.
6. По событию activation.expired или activation.cancelled отметьте тест как «без кода» и переходите дальше.

Проверяйте заголовок X-OTPRoute-Signature (HMAC-SHA256 от <t>.<raw body>) и отклоняйте устаревшие метки времени. Руководство по интеграции разбирает каждый вызов.

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

Откройте OTP Gateway в панели, выберите Гонконг и сервис, проверьте показанную цену и оформите заказ. Скопируйте номер в приложение, затем следите за карточкой активации: код появится на ней, как только будет получен. Это удобно для сотрудников поддержки, воспроизводящих обращение клиента на том же маршруте, который использует ваш CI.

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

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

• проверьте, не отказывает ли сервис виртуальным номерам — некоторые так делают;
• повторите позже или через другой маршрут сервиса;
• убедитесь, что приложение получило все восемь цифр после +852: форма, подставляющая лишний ведущий ноль, ломает номер;
• не заказывайте заново в плотном цикле — это обычно повторяет тот же результат.

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

Долгосрочного номера +852 по самообслуживанию в OTP Route нет. Выделенные номера предлагаются только в США и Канаде, от $1.95/месяц, и описаны на странице виртуальных номеров. По гонконгской линии напишите на [email protected]; возможность её предоставить зависит от местных правил.

Всё остальное оплачивается по факту использования с предоплаченного кошелька в USD, пополнение картой или USDT/USDC, с PDF-счётом за каждое пополнение. Режим песочницы с имитированными номерами доступен по запросу для аккаунтов разработчика. Соблюдайте условия каждого сервиса и Политику допустимого использования.

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

Можно ли получить SMS с OTP из Гонконга без местной SIM-карты?

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

Нужно ли убирать транковую приставку из гонконгских номеров?

Нет. В Гонконге транковой приставки нет, поэтому восемь местных цифр идут сразу после +852.

Какой id страны в API для Гонконга?

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

Придёт ли код на китайском или английском?

Возможно и то и другое — в зависимости от сервиса и языковых настроек аккаунта. Разбирайте цифры по шаблону, чтобы работали оба варианта.

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

От $0.20 за код; актуальная цена по сервису приходит из GET /api/v1/prices и показывается в панели перед заказом.

Вернут ли деньги, если WeChat или другой сервис ничего не отправит?

Да. Любая активация, по которой за 20 минут не пришло SMS или которую вы отменили, возвращается на кошелёк в полном объёме.

Подходит ли OTP-маршрутизация в Гонконг для CI-конвейеров?

Подходит, если использовать вебхуки или умеренный опрос и считать истечение срока обычным исходом. См. статью о CI-конвейерах.

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