Тестирование и работа с номерами верификации Макао +853

Чем номера Макао отличаются от номеров Гонконга и материкового Китая?

У Макао собственный телефонный код страны, +853, отдельный от +852 для Гонконга и +86 для материкового Китая. Это звучит очевидно, но выпадающие списки телефонов, которые объединяют все три под одним флагом или угадывают код по локали браузера, — частый источник неудачных регистраций в регионе.

Местные номера состоят из восьми цифр без транкового префикса, а мобильные начинаются с 6. В формате E.164 мобильный номер Макао — это +853 и эти восемь цифр. При нормализации ввода удаляйте пробелы и дефисы, допускайте необязательный ведущий 853 и отклоняйте номера, длина которых принадлежит соседу: одиннадцатизначный мобильный номер материкового Китая, вставленный в поле +853, должен не пройти валидацию, а не молча отправить SMS в никуда.

Если вы обслуживаете и более широкий регион, в каталоге рядом с этим маршрутом находятся маршруты Гонконга и Тайваня.

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

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

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

Зачем командам номер верификации Макао?

Экономика Макао сильно зависит от туризма, гостиничного дела и услуг, принимающих гостей со всей Азии, поэтому многие используемые там приложения — региональные или международные, а не сугубо местные. Типичные причины, по которым бизнес тестирует номера +853:

• Туристический, бронирующий или лояльностный продукт убеждается, что регистрация работает для жителей Макао, а не только для гостей.
• Мессенджер или маркетплейс проверяет локализацию на традиционный китайский сквозным образом.
• Операционная команда ведёт бизнес-профили заведения в Макао и не хочет, чтобы сотрудники использовали личные SIM-карты.
• QA-группа добавляет территорию в региональную матрицу рядом с Гонконгом и Тайванем.

Случай управления аккаунтами подробнее описан на странице для операционных команд.

Какие сервисы доступны на номере Макао через OTP Gateway?

На маршруте Макао сейчас доступно более 1 600 сервисов. Важные для этой части Азии — WeChat, WhatsApp, LINE, KakaoTalk, Telegram, Google (Gmail и YouTube), Facebook, Instagram, Microsoft и Outlook, Amazon, AliExpress, Airbnb, Netflix и Discord.

Набор меняется в течение дня, поэтому автоматические прогоны должны спрашивать у API, что доступно для mo, а не полагаться на сохранённый список.

Как получать коды Макао через API?

Всё находится под https://otproute.com/api/v1 и аутентифицируется Bearer-ключом с префиксом or_live_. Идентификатор страны — mo.

1. Один раз узнайте идентификаторы сервисов через GET /api/v1/services.
2. Подтвердите стоимость через GET /api/v1/prices?country=mo&service=wechat.
3. Закажите через POST /api/v1/activations с телом {"service": "wechat", "country": "mo"} и сохраните идентификатор активации.
4. Инициируйте SMS из приложения, используя полученный номер +853.
5. Заберите результат опросом GET /api/v1/activations/{id} или из вебхука activation.sms_received.

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

Что делать, если код +853 не пришёл?

Заказы остаются открытыми 20 минут, и вы платите, только если код пришёл. Если окно истекло или вы отменили заказ через POST /api/v1/activations/{id}/cancel, вся сумма возвращается на ваш кошелёк.

Когда ничего не приходит, дождитесь окончания окна, а затем подумайте, не отклоняет ли сервис виртуальные номера; некоторые так делают, и именно эту ситуацию покрывает возврат. Повторите позже или через другой маршрут сервиса и добавьте задержку с нарастанием (backoff), чтобы повторы в скриптах не накапливались. Когда для вашего теста имеет смысл переключиться на соседний маршрут, объясняет статья о маршрутизации по странам.

Можно ли сохранить номер Макао и как устроена оплата?

Самообслуживаемой долгосрочной линии Макао не предлагается. Dedicated Numbers, которые продолжают принимать SMS и поддерживают исходящие звонки из браузера, продаются только для США и Канады, от $1.95/месяц. Командам, которым нужна постоянная линия +853, можно написать на [email protected], но возможность определяется местным регулированием.

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

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

Можно ли протестировать регистрацию в Макао, не находясь там?

Да. Номер OTP Gateway с кодом +853 принимает SMS, а вы читаете его в панели или через API.

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

Используйте mo в запросах вроде GET /api/v1/prices?country=mo&service=whatsapp.

Сколько цифр в мобильном номере Макао?

Восемь цифр после +853, обычно начинающихся с 6; транкового префикса, который нужно убирать, нет.

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

От $0.20 за код, в зависимости от сервиса. API и панель показывают актуальную цену до заказа, а неудачные заказы возвращаются.

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

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

Доступен ли долгосрочный номер Макао?

Не как самообслуживаемый продукт; Dedicated Numbers есть только в США и Канаде. Напишите в поддержку, чтобы узнать о +853.

Можно ли разработать интеграцию, не платя за реальные номера?

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

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