Коды подтверждения Monaco (+377) для продуктовых и QA-команд

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

Монако крошечное, но для бизнеса в сфере частного банковского обслуживания, гостеприимства, яхтенных услуг и международных мероприятий значит больше, чем подсказывает размер. Клиенты там ожидают, что продукт без возражений примет номер +377, а удивительно много форм по-прежнему исходят из того, что у любого на Ривьере есть французская линия +33.

Это допущение порождает настоящие обращения в поддержку. Многие, кто работает в Монако, живут по ту сторону границы во Франции и пользуются французскими номерами, а резиденты держат монакские, так что в одной клиентской базе смешаны оба кода. Номер подтверждения Monaco, заказанный как номер +377 для тестов, позволяет QA-инженерам доказать, что список стран, правила валидации и SMS-шаблоны воспринимают княжество как отдельную страну, а не как французский пригород.

Как форме хранить и проверять номера +377?

У Монако собственный код страны, отдельный от Франции, а его национальные номера короткие по меркам большей части Европы. В международной форме префикса для внутренних звонков нет: номер — это +377 и сразу абонентские цифры.

Несколько практических правил для инженеров:

• Сохраняйте номера в E.164 (+377…), а удобную группировку применяйте только при отображении.
• Пользователи, привыкшие к французскому набору, иногда по привычке вводят ведущий 0. Убирайте его при нормализации, а не заваливайте валидацию.
• Не выводите страну из префикса +33 и монакского почтового адреса; держите страну телефона и страну оплаты независимыми полями.
• Используйте поддерживаемую библиотеку для телефонных номеров вместо самодельной проверки длины, потому что зашитые французские длины отвергают корректные монакские номера.

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

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

На маршруте Monaco сейчас доступно более 1,300 сервисов. Среди популярных в сегодняшнем срезе Instagram, Airbnb, Telegram, Claude, WhatsApp, Facebook, Google (Gmail & YouTube), Uber, Netflix, eBay, LinkedIn и X (Twitter).

Покрытие не фиксировано. Операторы-партнёры меняют мощности в течение дня, поэтому сервис, видимый утром, к вечеру может быть приостановлен. Грамотная маршрутизация OTP читает наличие в момент заказа, а не опирается на кешированный список, и SMS verification API отдаёт именно это через эндпоинт цен.

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

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

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

Проверяйте заголовок X-OTPRoute-Signature каждого вебхука: пересчитайте HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта и отклоняйте старые метки времени. Каждый аккаунт может зарегистрировать 5 эндпоинтов вебхука и отправлять до 300 запросов в минуту, чего хватает для параллельных прогонов по Monaco. Те же шаги с обработкой ошибок разобраны в руководстве по интеграции.

Есть ли способ без кода для операционных сотрудников?

Дашборд повторяет тот же путь для тех, кто предпочитает не трогать API. Выберите Monaco в OTP Gateway, выберите сервис, проверьте появившуюся цену и подтвердите. Номер +377 отображается на карточке активации; вставьте его на экран входа или регистрации, и код появится на этой карточке, когда придёт SMS.

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

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

В небольших странах меньше маршрутов, поэтому терпение и запасной план важнее, чем в крупных.

• Дайте заказу полное окно, прежде чем отменять.
• Проверьте, принимает ли сервис виртуальные номера для этого действия; некоторые отвергают их сразу.
• Повторите после паузы, а не заказывайте снова в цикле: это может сработать как ограничение частоты на стороне сервиса.
• Если тесту нужен лишь номер региона Ривьеры, у маршрута France или маршрута Italy в этот момент может быть больше мощностей.

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

Можно ли сохранить номер Monaco надолго и как устроена оплата?

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

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

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

Совпадает ли телефонный номер Monaco с французским?

Нет. У Монако собственный код +377, поэтому логика валидации должна обрабатывать его отдельно от французского +33.

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

Используйте mc в запросе цен и в теле запроса активации.

Можно ли получить номер +377 для тестирования европейского запуска?

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

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

Каждая активация открыта 20 минут; если ничего не пришло, плата возвращается автоматически.

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

Не в международном формате. Уберите ведущий 0, который вводит пользователь, и храните номер как +377 и абонентские цифры.

На каком языке придёт проверочное SMS от монакского сервиса?

Обычно на французском, но это зависит от приложения и языковой настройки аккаунта, так что возможны тексты на английском или итальянском.

Можно ли гонять тесты Monaco, не тратя реальные средства?

Запросите режим песочницы для аккаунта разработки. Он возвращает имитированные номера и коды для интеграционного тестирования.

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