Приём SMS с OTP из Непала: подготовка, шаги и решения проблем для тестов +977

Перед стартом: что должно быть готово до заказа номера Непала?

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

1. Учётные данные. Создайте ключ or_live_ в консоли разработчика и передавайте его как Bearer-токен. Отдельные ключи для локальной разработки, CI и продакшен-инструментов делают ротацию безболезненной.
2. Идентификаторы страны и сервиса. Непал — np; идентификатор сервиса найдите через GET /api/v1/services.
3. Средства или песочница. Проверьте GET /api/v1/balance или попросите перевести тестовый аккаунт в режим песочницы, чтобы симулированные номера и коды позволяли отрабатывать интеграцию бесплатно.
4. Способ доставки. Выберите между вебхук-эндпоинтом и опросом до того, как напишете тестовую обвязку, а не на полпути.
5. Просмотр входящих с поддержкой Unicode. Коды из шаблонов на непальском приходят на деванагари, и ваши логи должны отображать их правильно.

Если модель вам в новинку, материал что такое OTP-шлюз даст базовое представление за несколько минут.

Какие приложения могут доставлять коды на линию +977?

Сейчас на Непал можно направить более 1 700 сервисов. Среди популярных — Viber, WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Discord, Signal, imo, Amazon и Claude.

Этот список — срез, а не обещание. Доступность меняется в течение дня, поэтому GET /api/v1/prices?country=np&service=<id> возвращает актуальные цену и наличие для именно той пары, которая нужна вашему тесту.

Шаг за шагом: получение SMS с OTP из Непала через API

Когда список подготовки выполнен, поток OTP API для Непала состоит максимум из пяти вызовов:

1. Подтвердите актуальную цену для np и вашего сервиса.
2. Создайте активацию через POST /api/v1/activations с телом {"service": "<id>", "country": "np"}. Сохраните возвращённый идентификатор активации: на нём строится всё дальнейшее.
3. Введите номер +977 в тестируемом сценарии и запустите отправку SMS.
4. Заберите код из вебхука activation.sms_received или опрашивайте GET /api/v1/activations/{id} с разумной задержкой между вызовами.
5. Отмените заказ через POST /api/v1/activations/{id}/cancel, если тест прерван раньше времени.

На стороне вебхука проверяйте X-OTPRoute-Signature, прежде чем доверять запросу: соберите <t>.<raw body>, подпишите HMAC-SHA256 с секретом эндпоинта, сравните с v1 и отклоняйте устаревшие метки времени. Затем выполняйте upsert по идентификатору активации, чтобы повторно доставленное событие не причинило вреда. Полный шаблон показывает материал приём OTP через вебхуки.

Предпочитаете кликать, а не программировать? В кабинете OTP Route выберите Непал, выберите сервис, согласитесь с показанной ценой — появится номер с таймером; код отобразится на том же экране.

Проверки форматирования непальских мобильных номеров

Непальские мобильные номера состоят из десяти цифр и начинаются с 9, чаще всего с 98 или 97. Внутри страны городские номера набираются с магистральным 0 и кодом региона, но этот 0 никогда не входит в международный формат. Тестовая запись должна выглядеть как +97798xxxxxxxx.

Что стоит проверить в тестах валидации:

• Пользователь, ввёл номер с ведущим 0, получает после +977 номер с отброшенным 0.
• Десятизначный мобильный без какого-либо префикса принимается и нормализуется до E.164.
• Пробелы и дефисы, которые пользователи вставляют из карточек контактов, очищаются перед сохранением.

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

Почему команды создают продукты и тестируют их для рынка Непала

Непал важен для большего числа продуктов, чем можно судить по его размеру. Значительная часть непальских работников живёт за границей, поэтому сервисы денежных переводов, кошельки и мессенджеры, обслуживающие коридоры в страны Персидского залива, Малайзию и другие, часто должны верифицировать пользователей, у которых по-прежнему есть номер +977. Мессенджеры вроде Viber и WhatsApp — часть повседневного общения.

Команды заказывают номер +977 для тестирования, когда они:

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

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

Устранение проблем: код не пришёл

У пропавших кодов есть несколько обычных причин, и решение редко сводится к немедленному повторному заказу.

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

Событие activation.expired — чёткий сигнал, что ничего не пришло и ничего не списано.

Долгосрочные линии и оплата маршрутов Непала

OTP Route не предлагает самостоятельно оформляемого долгосрочного номера Непала. Выделенные номера (Dedicated Numbers) есть только в США и Канаде, от $1.95/месяц. Если вашей команде нужна постоянная линия +977, напишите на [email protected]; возможность зависит от местных правил, и ничего не гарантировано.

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

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

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

Да. OTP Gateway выдаёт номер +977 для одной верификации, а код вы читаете в кабинете или через API.

Какой код страны ожидает API для Непала?

Передавайте np как страну в запросах цен и активаций.

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

Нет. Отбросьте магистральный 0 и храните номер в формате E.164 после +977.

Корректно ли отображаются коды на непальском в кабинете?

Сообщение показывается так, как получено; убедитесь, что ваши логи и тестовые проверки работают с текстом на деванагари, чтобы код извлекался надёжно.

Что будет с деньгами, если код из Непала так и не придёт?

Ничего не списывается: активация, по которой за 20 минут не пришло SMS, или отменённая вами возвращается на кошелёк полностью без каких-либо запросов с вашей стороны.

Можно ли использовать тот же номер +977 для последующего входа?

Нет, каждый номер OTP Gateway принимает один код. Для аккаунтов, которым позже нужно снова входить, подходит выделенный номер, но они предлагаются только в США и Канаде.

Есть ли правила использования номеров верификации Непала?

Да. Соблюдайте условия каждого сервиса и Политику допустимого использования и применяйте номера только для тестирования или ведения собственных законных продуктов и аккаунтов.

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