Тестируем телефонную верификацию +596 для пользователей Мартиники

Почему Мартиника ломает валидацию телефонов, рассчитанную только на Францию?

Мартиника входит в состав Франции и Европейского союза, но у неё свой телефонный код страны, +596, а не +33. Отсюда классическая ошибка: французский продукт ограничивает поле телефона кодом +33 или список стран прячет Мартинику под Францией, и клиенты на острове не могут завершить регистрацию.

Местные номера следуют французскому десятизначному шаблону с транк-нулём 0. Мобильные номера обычно пишут как 0696 или 0697 и ещё шесть цифр, а городские начинаются с 0596. В E.164 ноль убирается и добавляется код, получается +596 696 xx xx xx для мобильного. Обратите внимание на особенность городских номеров: +596 596… повторяет цифры, и некоторые самодельные валидаторы ошибочно принимают это за опечатку.

• Храните +596 и девять цифр; пробелы добавляйте только при отображении.
• Убирайте транк-ноль, когда пользователь вводит 0696… при выбранном острове.
• Проверьте, что +596, Гваделупа (+590) и Французская Гвиана (+594) принимаются как отдельные коды.

Кому нужен номер +596 для тестирования?

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

• Запуски во Франции и ЕС, где жителей заморских территорий нужно обслуживать как местных клиентов.
• Карибские операции для туристических, доставочных и гостиничных продуктов, которыми пользуются на острове.
• Регрессионные наборы, покрывающие разбор телефонов, шаблоны SMS и сценарии восстановления для менее распространённых телефонных кодов.

На странице руководства по QA-тестированию описано, как встроить такие проверки в существующий конвейер.

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

На маршруте Мартиники доступно более 600 сервисов. В текущем срезе популярных есть WhatsApp, Telegram, Google (Gmail и YouTube), Facebook, Instagram, TikTok, Microsoft и Outlook, Amazon, Discord, Snapchat, Airbnb, Uber и Netflix.

Доступность меняется в течение дня, поэтому считывайте её из API в тот момент, когда она нужна, а не зашивайте в тест-план.

Как получать SMS OTP Мартиники через API?

Создайте Bearer-ключ (префикс or_live_) в консоли разработчика и направьте клиент на https://otproute.com/api/v1. Идентификатор Мартиники — mq.

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

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

Есть ли путь через панель для тех, кто не пишет код?

Сотрудники поддержки и growth-команды могут выполнять ту же OTP-маршрутизацию из браузера. Зарегистрируйтесь по почте или через Google, пополните кошелёк, выберите Мартинику и сервис, проверьте показанную цену и подтвердите. Номер +596 появится на экране, а код добавится на ту же карточку, когда придёт SMS. Окно — 20 минут; если SMS не пришло или вы отменили заказ, деньги сразу возвращаются на баланс.

Что делать, если код +596 опаздывает или не приходит?

Небольшие маршруты могут быть тише, поэтому закладывайте это заранее:

• Дождитесь полного окна, прежде чем считать попытку неудачной.
• Помните, что сервис может отклонять виртуальные номера; в таком случае деньги не списываются.
• Повторите после паузы или используйте соседний маршрут, например Гваделупу, если сценарий позволяет.
• Не долбите endpoint заказа: лучше разнести повторные попытки во времени.

Больше идей в чек-листе по сбоям доставки. Соблюдайте условия каждого сервиса; действует Политика допустимого использования OTP Route.

Можно ли получить постоянный номер Мартиники и как платить?

Самостоятельных долгосрочных номеров для Мартиники нет. Выделенные линии существуют только для США и Канады, от $1.95/month; ради мартиникской линии напишите на [email protected], помня, что возможности определяют местные правила.

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

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

Совпадает ли номер Мартиники с французским номером +33?

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

Как выглядит мартиникский мобильный номер в E.164?

Уберите ведущий ноль и добавьте код: номер 0696 xx xx xx превращается в +596 696 xx xx xx.

Какой идентификатор страны передавать для Мартиники?

Передавайте mq в значении country в запросах цен и активаций.

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

Да. Закажите номер +596 для нужного сервиса в OTP Gateway и прочитайте код в панели или через API.

Платится ли активация +596, по которой SMS так и не пришло?

Нет. Истёкшие и отменённые активации возвращаются на кошелёк полностью; вы платите, только когда код пришёл.

Продаёт ли OTP Route долгосрочные номера Мартиники?

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

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