Коды верификации Вьетнама (+84) — сразу в ваш набор тестов

Чем интересно тестирование на реальном маршруте +84 во Вьетнаме?

Вьетнам — рынок, ориентированный на мобильные устройства, где мессенджеры, социальная коммерция и сервисы формата суперприложений занимают центральное место в повседневной жизни. Zalo — широко распространённый местный мессенджер, а маркетплейсы вроде Shopee и Lazada известны каждому. Продуктовые команды тестируют здесь при запуске вьетнамской версии, проверке вьетнамскоязычного онбординга или поддержке клиентов по всей Юго-Восточной Азии из регионального центра. На странице верификация мобильных приложений описано, как такое тестирование обычно вписывается в релизный цикл.

Как форматируются вьетнамские мобильные номера?

Внутри страны мобильные номера записываются с транковым 0 и десятью цифрами в сумме, начиная с префиксов вроде 03, 05, 07, 08 или 09. В 2018 году страна перевела прежние одиннадцатизначные мобильные номера на десять цифр, поэтому в старых данных CRM могут оставаться устаревшие префиксы.

Для хранения отбросьте 0 и используйте E.164: +84 и девять цифр. Нормализуйте номер при вводе, а форматирование для показа делайте отдельно.

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

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

Сейчас для Вьетнама указано более 2 800 сервисов. Среди часто запрашиваемых — Zalo, Shopee, Lazada, TikTok, Facebook, Telegram, WhatsApp, Google (Gmail и YouTube), Instagram, Microsoft и Outlook, Amazon, ChatGPT (OpenAI), Discord и Viber. Доступность меняется в течение дня, поэтому читайте её в реальном времени, а не закладывайте допущения в код.

Что должен охватывать QA-прогон для Вьетнама?

Помимо получения кода, полезный прогон на +84 проверяет те части онбординга, которые на этом рынке ломаются чаще всего:

• поле телефона принимает и национальный ввод 09…, и международный +84 9… и сохраняет их одинаково;
• в вашей вьетнамской сборке селектор страны корректно показывает Việt Nam вместе с диакритикой;
• автозаполнение OTP на Android и iOS по-прежнему подхватывает цифры, когда окружающий текст написан без диакритики;
• текст ошибки для неверного или просроченного кода звучит естественно по-вьетнамски, а не как буквальный перевод;
• кнопка повторной отправки ждёт достаточно долго, чтобы медленную доставку не опередил второй запрос.

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

Как работает API OTP для Вьетнама от начала до конца?

Запросы отправляются на https://otproute.com/api/v1 с Bearer-ключом (префикс or_live_). Идентификатор страны для Вьетнама — vn.

1. Запросите GET /api/v1/prices?country=vn&service=zalo, чтобы подтвердить цену и доступность.
2. Зарезервируйте номер, отправив на POST /api/v1/activations тело {"service": "zalo", "country": "vn"}; сохраните возвращённый идентификатор активации.
3. Введите полученный номер +84 на экране верификации вашего приложения.
4. Получайте activation.sms_received на вебхук или опрашивайте GET /api/v1/activations/{id} каждые несколько секунд.
5. Ненужные активации закрывайте через POST /api/v1/activations/{id}/cancel.

Перед тем как доверять вебхуку, проверяйте его X-OTPRoute-Signature. Полную настройку для CI см. в статье тестирование SMS OTP в CI-пайплайнах.

Могут ли специалисты без навыков программирования заказать номер +84?

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

Продаёт ли OTP Route долгосрочные вьетнамские номера?

Нет. Самостоятельные выделенные виртуальные номера (Dedicated Virtual Numbers) существуют только в США и Канаде, от $1.95/month. Для Вьетнама каждый номер OTP Gateway принимает один код. Командам, которым нужна постоянная линия +84, можно написать на [email protected], хотя возможность зависит от местного регулирования. Сравните обе модели на странице виртуальных номеров.

Как оплачивается тестирование на +84?

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

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

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

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

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

Нет. Храните их как +84 и девять цифр, а 0 возвращайте только при показе номера в национальном формате.

Почему в старых данных клиентов вьетнамские мобильные номера одиннадцатизначные?

В 2018 году Вьетнам перевёл одиннадцатизначные мобильные номера на десять цифр. Записи, созданные до этого изменения, возможно, придётся перенести на актуальные префиксы.

Будут ли во вьетнамских сообщениях с кодами диакритические знаки?

Часто нет, потому что многие отправители убирают диакритику из SMS. Убедитесь, что парсер кода опирается на цифры, а не на слова вокруг.

Что делать, если код Zalo или Shopee не приходит на номер +84?

Оставьте активацию открытой на все 20 минут, чтобы произошёл автоматический возврат, затем повторите позже или выберите другой маршрут. Некоторые сервисы отклоняют виртуальные номера, а частые повторные заказы подряд вряд ли помогут.

Сколько сервисов поддерживает маршрут Вьетнама?

Сейчас более 2 800. Актуальный список даёт GET /api/v1/services вместе с GET /api/v1/prices для идентификатора страны vn.

Принимает ли каждое приложение номер +84 от OTP Route?

Нет, приём не гарантируется: каждый сервис сам определяет политику по виртуальным номерам. Вы платите только тогда, когда код доставлен.

Какие правила использования действуют для вьетнамских номеров?

Верифицируйте только собственные продукты и бизнес-аккаунты, соблюдайте условия каждого сервиса и Политику допустимого использования OTP Route. Массовое или дублирующее создание аккаунтов запрещено.

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