Французские (+33) проверочные коды в вашем процессе QA и запуска

Мы запускаемся во Франции в следующем квартале. Как протестировать шаг с телефоном?

Французский запуск обычно приходит с длинным чек-листом локализации: переведённые тексты, формат евро, новый баннер согласия и онбординг, который теперь ожидает номер +33. Шаг с телефоном — тот, что склонен ломаться незаметно. Валидаторы, написанные для другого рынка, отклоняют ведущий 0, шаблон SMS по-прежнему на английском, или кнопка повторной отправки ведёт себя иначе, когда задействован настоящий французский операторский маршрут.

Проверочный номер Франции из OTP Gateway позволяет команде отработать этот шаг раньше клиентов. Закажите линию +33 для тестируемого сервиса, пройдите сценарий, прочитайте код и идите дальше. Это одинаково подходит growth-команде, проверяющей реферальную воронку, и агентству, проверяющему приложение клиента перед сдачей; об этом сценарии рассказывает страница агентства и реселлеры.

Как выглядит поток France OTP API на практике?

Используйте id страны fr со стандартными эндпоинтами под https://otproute.com/api/v1:

• GET /api/v1/countries и GET /api/v1/services возвращают id, которые можно сочетать.
• GET /api/v1/prices?country=fr&service=<id> сообщает текущую цену пары.
• POST /api/v1/activations с {"service": "<id>", "country": "fr"} резервирует номер +33 и возвращает id активации.
• GET /api/v1/activations/{id} сообщает статус и код, когда он придёт; POST /api/v1/activations/{id}/cancel останавливает ненужный заказ.

Большинство CI-конвейеров предпочитает подписанный вебхук опросу. Зарегистрируйте эндпоинт, слушайте activation.sms_received, activation.expired и activation.cancelled, проверяйте HMAC в X-OTPRoute-Signature по секрету вашего эндпоинта и отклоняйте всё со старой меткой времени. Ключи имеют префикс or_live_, на аккаунт доступно до 10 ключей и потолок 300 запросов в минуту. На странице решения для CI/CD показано, как команды встраивают это в ночные прогоны.

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

В актуальном списке для fr более 2 300 сервисов. Команды, локализующие продукт для Франции, обычно начинают с WhatsApp, Google (Gmail & YouTube), Uber, Airbnb, Amazon, Instagram, Facebook, Snapchat, LinkedIn, Telegram, Microsoft & Outlook, Netflix, eBay и ChatGPT (OpenAI). Поскольку наши операторы-партнёры обновляют инвентарь в течение дня, проверяйте доступность через API в момент заказа, а не закладывайте предположения в код.

Какие особенности французских номеров ломают валидаторы?

Франция использует +33 и транковый префикс 0. Мобильный номер, записанный локально как 06 12 34 56 78 или 07 12 34 56 78, в международном виде становится +33 6 12 34 56 78, то есть национальный значимый номер после отбрасывания нуля состоит из девяти цифр. Храните E.164 (+336... или +337...), показывайте французским пользователям группами по две цифры и убирайте 0, когда кто-то вводит внутренний формат после выбора +33.

Заморские департаменты, такие как Гваделупа, Мартиника и Реюньон, имеют собственные коды стран (+590, +596 и +262), поэтому форма, исходящая из «французский клиент — значит +33», неправильно обработает их. Проверочные тексты на французские номера часто приходят на французском, когда сервис локализуется по номеру или языку аккаунта, поэтому эти маршруты хорошо проверяют, что ваши собственные шаблоны SMS и тексты в приложении соответствуют.

Может ли нетехнический коллега сделать это из браузера?

Да. После того как вы создадите аккаунт по коду из письма или через Google, откройте OTP Gateway в панели управления, выберите Францию и сервис, проверьте цену и подтвердите. Номер +33 появится сразу, а код отобразится рядом с заказом, как только придёт SMS. Продакт-менеджерам, проводящим быструю приёмку на staging, редко нужно что-то ещё.

Что делать, если SMS не доходит до номера +33?

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

1. Дайте окну отработать, а не отменяйте через минуту.
2. Убедитесь, что сервис готов отправлять на виртуальные номера; некоторые отклоняют их намеренно.
3. Закажите снова чуть позже или попробуйте другой маршрут, например тот же сервис на номере Бельгии, если сценарий теста это допускает.
4. Не заказывайте повторно в плотном цикле; разнесённые повторы бережнее и к лимиту запросов, и к целевому сервису.

Истёкшие и отменённые активации автоматически возвращаются на кошелёк.

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

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

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

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

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

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

Какой id страны использует OTP Route для Франции?

Франция — это fr в каждом вызове API, включая запросы цен и активации.

Сколько стоит проверочный номер Франции?

OTP Route берёт от $0.20 за код; точная цена зависит от сервиса и показывается перед заказом.

Охватывают ли французские OTP-номера Гваделупу или Реюньон?

Нет, заморские департаменты имеют собственные коды стран и отображаются в актуальном списке как отдельные страны.

Выставят ли мне счёт, если код истечёт?

Нет. Когда активация выходит за 20-минутное окно без SMS или вы её отменяете, вся сумма возвращается на ваш кошелёк.

Есть ли правила использования этих номеров?

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

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