SMS-верификация в Никарагуа (+505) для QA и команд запуска

Как устроены номера +505 и как хранить их в базе данных?

Никарагуанские номера состоят из восьми цифр после кода страны +505, а магистрального префикса при внутренних звонках нет. Поэтому каноническая форма E.164 — это +505 и эти восемь цифр, и ничего больше.

Тонкая ловушка здесь региональная. Коста-Рика (+506), Гондурас (+504), Сальвадор (+503) и Гватемала (+502) тоже используют восьмизначные национальные номера, так что голая строка из восьми цифр ничего не говорит о стране. Практические правила для центральноамериканского продукта:

• Никогда не сохраняйте телефонный номер без кода страны, даже если интерфейс подставляет его заранее.
• Нормализуйте на сервере, а не только в браузере, чтобы импорт и API-клиенты следовали тому же правилу.
• Добавьте в фикстуры тестовый номер +505, чтобы регресс в выборе страны проявился как упавшая проверка, а не как обращение в поддержку.

На каком языке приходят сообщения с кодами в Никарагуа?

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

Для проверки локализации это значит две вещи: нужно убедиться, что ваши собственные испанские (латиноамериканские) строки вокруг поля ввода кода написаны верно, и что логика разбора кода, например подсказки автозаполнения или извлечение регулярными выражениями в тестах, не зависит от английских слов в теле сообщения.

Зачем командам тестировать или работать с никарагуанскими номерами?

Мало какие компании запускаются только в Никарагуа; обычно она входит в центральноамериканский выпуск. Типичные причины, по которым команде нужен никарагуанский номер для подтверждения:

• Проверки регионального запуска по всему перешейку, где нужно подтвердить путь регистрации, отображение валюты и маршрутизацию поддержки в каждой стране.
• Клиенты, живущие за границей, которые сохраняют SIM-карту +505 для семьи и банка, работая в соседних странах или в Северной Америке.
• Ближний аутсорсинг (nearshore), когда сотрудники поддержки или бэк-офиса ведут бизнес-аккаунты, а компания предпочитает не привязывать их к чьему-либо личному телефону.
• Проверки онбординга в финтехе и маркетплейсах; как команды выстраивают такие тесты, смотрите в разделе онбординг в финтехе.

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

Через OTP Gateway для Никарагуа доступно более 1000 сервисов. Сейчас среди популярных — WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Uber и Discord.

Этот список — лишь снимок. Доступность каждой пары меняется в течение дня, поэтому API сообщает её в реальном времени, а не в статичной таблице.

Как выглядят вызовы API для страны `ni`?

Авторизуйтесь на https://otproute.com/api/v1 с помощью Bearer-ключа, начинающегося с or_live_; ключи выпускаются в консоли разработчика, до 10 на аккаунт. Идентификатор страны Никарагуа — ni.

1. Один раз определите идентификаторы сервисов через GET /api/v1/services и проверьте страну через GET /api/v1/countries.
2. Узнайте актуальную цену через GET /api/v1/prices?country=ni&service=<id> и пропустите заказ, если сервис сейчас не предлагается.
3. Оформите заказ: POST /api/v1/activations с {"service": "telegram", "country": "ni"}. Сохраните возвращённый идентификатор активации.
4. Проведите шаг подтверждения в своём приложении с номером +505.
5. Дождитесь события activation.sms_received или опрашивайте GET /api/v1/activations/{id}. Ненужный тест освободите через POST /api/v1/activations/{id}/cancel.

Каждый вебхук содержит X-OTPRoute-Signature в виде t=<unix>,v1=<hex>; проверяйте его как HMAC-SHA256 от <t>.<raw body> с секретом конечной точки и отбрасывайте запросы со старыми метками времени. Привязывайте события к идентификатору активации, чтобы повторная доставка была безвредной. Лимит — 300 запросов в минуту и до 5 конечных точек вебхука. Подробнее — в документации для разработчиков и в руководстве по интеграции OTP API.

Проверка +505 из панели и что делать, если код не пришёл

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

Активация остаётся открытой 20 минут. Если за это время SMS не придёт или вы отмените заказ, вся сумма сама вернётся на ваш кошелёк; вы платите только за полученные коды. Время доставки зависит от сервиса и маршрута. Если ничего не появилось, дождитесь конца окна, затем повторите позже или попробуйте другой маршрут сервиса, а не отправляйте новые заказы один за другим. Также убедитесь, что сервис принимает виртуальные номера на этом шаге, поскольку некоторые их отклоняют. Соблюдайте условия каждого сервиса; действует Политика допустимого использования OTP Route.

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

Самостоятельно оформить долгосрочную линию для Никарагуа нельзя. Dedicated Virtual Numbers от $1.95/month продаются сразу только для США и Канады; подробности — на странице виртуальных номеров. Если нужна постоянная линия +505, напишите на [email protected], учитывая, что возможность зависит от местных правил.

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

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

Можно ли получать никарагуанские SMS-коды OTP, не находясь в Никарагуа?

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

Какой идентификатор страны использует API для Никарагуа?

Используйте ni в поле country запроса POST /api/v1/activations и в запросах цены.

Не путают ли никарагуанский номер с номерами Коста-Рики или Гондураса?

Это возможно, если хранить только национальные цифры, поскольку соседние страны тоже используют восьмизначные номера. Всегда храните полную форму E.164 с +505.

Сколько стоит номер для подтверждения в Никарагуа?

От $0.20 за код, в зависимости от сервиса. Деньги возвращаются автоматически, если SMS не пришло в течение 20-минутного окна или вы отменили заказ.

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

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

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

Не как самостоятельный продукт. Долгосрочные выделенные линии есть только в США и Канаде; о Никарагуа можно спросить, написав на [email protected].

Можно ли использовать OTP Route, чтобы открыть множество аккаунтов на одной платформе?

Нет. Используйте его для тестирования и работы со своими законными продуктами и аккаунтами — по одному на реального человека или компанию, в рамках условий каждой платформы.

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