Тестирование и работа с кодами подтверждения +376 в Андорре

Почему андоррские номера ломают формы регистрации?

Андорра использует код страны +376 и не имеет внутреннего префикса, поэтому ведущий ноль убирать не нужно. Большинство абонентских номеров состоит всего из шести цифр, что намного короче девятизначных национальных номеров в соседних Испании и Франции. Именно с длины QA-инженеру стоит начинать проверку: самописные регулярные выражения и устаревшие правила валидации часто требуют семь цифр и больше и молча отклоняют вполне корректный андоррский мобильный номер.

Практическое правило хранения:

• Сохраняйте номер в E.164 как +376 и шесть цифр, без пробелов и знаков препинания.
• Форматируйте только при отображении, например двумя группами по три цифры.
• Держите библиотеку метаданных телефонов актуальной, чтобы её правила длины для AD соответствовали действительности.

Заказ номера +376 для тестирования — самый быстрый способ убедиться, что ваша форма, столбец в базе данных и канал исходящих SMS принимают такой короткий номер от начала до конца.

Какие языки и сценарии клиентов важны в княжестве?

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

С Андоррой команды работают по нескольким повторяющимся причинам: розничные, туристические и горнолыжные компании, оформляющие гостей и жителей; фирмы, зарегистрированные в княжестве, которым нужен местный тест-кейс; трансграничные продукты для людей, которые живут по одну сторону Пиренеев, а работают по другую. Типичная ошибка — выбор страны, в котором Андорры нет или который молча подменяет её Испанией или Францией; реальный номер подтверждения +376 быстро её обнаруживает.

Какие сервисы могут доставить код на маршрут +376?

Андоррский маршрут — каталог поменьше, чем у крупных рынков: в актуальном списке более 50 сервисов. Среди популярных в текущем срезе — WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Microsoft & Outlook, Amazon, LinkedIn, Uber, Signal, Viber, Netflix и Airbnb.

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

Как выглядит последовательность вызовов API OTP для Андорры?

Создайте Bearer-ключ (префикс or_live_) в консоли разработчика и работайте с https://otproute.com/api/v1. Типичный прогон выглядит так:

1. Вызовите GET /api/v1/prices?country=ad&service=telegram, чтобы убедиться, что маршрут открыт, и увидеть актуальную цену.
2. Отправьте POST /api/v1/activations с телом {"service": "telegram", "country": "ad"} и сохраните возвращённые идентификатор активации и номер.
3. Запустите отправку проверочного SMS из тестируемого приложения или сценария.
4. Дождитесь вебхука activation.sms_received или опрашивайте GET /api/v1/activations/{id} с умеренным интервалом.
5. Если тест прерван, вызовите POST /api/v1/activations/{id}/cancel, чтобы средства сразу вернулись.

Каждый вебхук содержит заголовок X-OTPRoute-Signature. Пересчитайте HMAC-SHA256 от метки времени, точки и необработанного тела с секретом эндпоинта, сравните и отбросьте устаревшие метки времени. Аккаунту доступно до 10 ключей, 5 вебхук-эндпоинтов и 300 запросов в минуту. Остальное в этом API SMS-верификации описано в документации.

Может ли сотрудник операционного отдела сделать то же самое без кода?

Да. Любой член команды может использовать панель вместо API OTP для Андорры:

1. Войдите и откройте OTP Gateway.
2. Выберите Андорру и нужный сервис.
3. Проверьте показанную цену, затем закажите номер.
4. Вставьте номер +376 в сервис и запросите код.
5. Не закрывайте активацию на экране; код +376 отобразится в момент прихода.

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

Что делать, если код +376 не приходит?

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

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

Есть ли долгосрочная андоррская линия и как устроена оплата?

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

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

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

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

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

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

Используйте ad как значение страны в запросах цен и активаций.

Сколько стоит получение SMS OTP из Андорры?

Цена начинается от $0.20 за код и зависит от сервиса. Точная сумма возвращается через GET /api/v1/prices и показывается в панели до заказа.

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

Нет. В Андорре нет внутреннего префикса, поэтому номер — это просто +376 и абонентские цифры, обычно шесть.

Можно ли сохранить один и тот же номер +376 для повторных входов?

Не как самообслуживаемый продукт. Номера Gateway рассчитаны на один код; за постоянной линией вне США и Канады напишите на [email protected].

Могут ли наши разработчики прототипировать интеграцию с Андоррой, не трогая средства кошелька?

Да. Попросите поддержку перевести аккаунт разработки в режим песочницы, который возвращает симулированные номера и коды.

Спишутся ли деньги, если Telegram не пришлёт код?

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

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