Получение OTP Zalo на номера OTP Route через API

Как выглядит процесс получения кода подтверждения Zalo через API?

Идентификатор сервиса — zalo. Запросы идут на https://otproute.com/api/v1 с Bearer-ключом с префиксом or_live_, который выдаётся в консоли разработчика.

1. Получите идентификаторы стран через GET /api/v1/countries; например, Вьетнам — это vn.
2. Проверьте актуальную цену и доступность через GET /api/v1/prices?country=vn&service=zalo.
3. Создайте активацию: POST /api/v1/activations с телом {"service": "zalo", "country": "vn"}. Сохраните идентификатор активации и полученный номер.
4. Введите номер на экране телефона Zalo у тестового аккаунта, который вы контролируете.
5. Получите код через вебхук или опрос либо завершите заказ командой POST /api/v1/activations/{id}/cancel.

Проверка баланса через GET /api/v1/balance в начале набора тестов поможет избежать сюрпризов посреди прогона. Полные форматы запросов — в документации API.

Как построить приёмник вебхуков для кодов Zalo

Зарегистрируйте эндпоинт в консоли разработчика и подпишитесь на activation.sms_received, activation.expired и activation.cancelled. Каждый запрос содержит заголовок X-OTPRoute-Signature вида t=<unix>,v1=<hex>; вычислите HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта, сравните за постоянное время и отклоняйте старые метки времени.

Сделайте обработчик идемпотентным, сохраняя результаты по идентификатору активации. Если одно и то же событие пришло дважды, вторая запись должна ничего не менять. Команды без публичного эндпоинта могут вместо этого опрашивать GET /api/v1/activations/{id}; лимит в 300 запросов в минуту оставляет запас для короткого интервала опроса при нескольких параллельных тестах.

Когда Zalo запрашивает номер телефона?

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

Для QA-команд это важно: интеграции с мессенджером, мини-приложению или каналу поддержки на базе Zalo часто нужен свежий проверенный тестовый аккаунт, прежде чем можно будет запускать другие сценарии.

В каких странах можно получить OTP Zalo в OTP Route?

Маршруты Zalo доступны в 198 странах. Среди них Вьетнам, США, Япония, Южная Корея, Тайвань, Австралия, Канада, Камбоджа, Лаос, Таиланд, Малайзия, Сингапур, Германия, Франция и Великобритания.

Выбирайте страну, соответствующую тестируемому аккаунту. Для запуска во Вьетнаме нужны номера +84, чтобы воспроизвести то, что видят местные пользователи, а команде, обслуживающей вьетнамскую диаспору, могут понадобиться номера стран, где живут её клиенты. Страна также влияет на цену и доступность, поэтому сначала стоит проверить эндпоинт цен.

Шаги в панели управления для теста SMS-верификации Zalo

Не все в проекте пишут код. В панели выберите Zalo как сервис, укажите страну, подтвердите показанную цену и сделайте заказ. Скопируйте номер в Zalo; код появится рядом с заказом, когда придёт SMS. Отмена на том же экране возвращает всю сумму. Для регистрации в самой панели нужны адрес email и 6-значный код из письма либо вход через Google, а двухфакторная защита TOTP может защитить общий вход команды.

Почему код Zalo может не прийти?

Доставка зависит от сервиса и маршрута, поэтому фиксированного времени ожидания нет. Zalo также может отклонять некоторые виртуальные номера — именно для этого предусмотрен возврат средств. Если ничего не появилось:

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

Стоит ли использовать выделенный номер для тестового аккаунта Zalo?

Номер OTP Gateway рассчитан на один код. Если тестовый или служебный аккаунт должен снова войти в систему в следующем месяце, лучше подойдёт выделенный номер (Dedicated Number): линия США или Канады от $1.95/месяц, которая остаётся у вас при продлении, с входящими SMS в панели и на вебхуке number.sms_received. Подробнее — на странице виртуальных номеров.

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

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

Какой идентификатор сервиса использует API OTP Route для Zalo?

Это zalo; его передают в теле POST /api/v1/activations вместе с идентификатором страны.

Можно ли получить OTP Zalo на номер за пределами Вьетнама?

Да. Маршруты Zalo доступны в 198 странах, а доступность каждой возвращается в реальном времени эндпоинтом цен.

Спишутся ли деньги, если Zalo отклонит виртуальный номер?

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

Подходит ли виртуальный номер для Zalo, если аккаунт нужен надолго?

Одноразовый номер — нет. Для повторных входов безопаснее выделенный номер США или Канады, который остаётся у вас при продлении.

Как оплатить SMS-верификацию Zalo для тестирования?

Пополните предоплаченный кошелёк в долларах США картой или в USDT/USDC; абонентской платы нет, а к каждому пополнению прилагается счёт в PDF.

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

Да. Когда поддержка переведёт девелоперский аккаунт в песочницу, заказы Zalo будут возвращать имитированные номера и коды, и код вебхуков и опроса можно проверить до реальных трат.

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