Номера +594 (Французская Гвиана) для верификации: разработчикам и QA

Один код или номер «на постоянку»: что доступно для Французской Гвианы?

Прежде чем писать код, определите, какой продукт нужен для задачи.

• OTP Gateway подходит для разовых проверок: убедиться, что ваша регистрация принимает номер Французской Гвианы, прогнать регрессию перед релизом или один раз настроить региональный бизнес-профиль. Каждый номер используется для одного кода.
• Dedicated Virtual Numbers (выделенные виртуальные номера) нужны аккаунтам, которым нужно получать коды постоянно, например тестовому логину, в который ваша QA-команда заходит каждую неделю. Они продаются мгновенно только в США и Канаде, от $1.95/month.

Французская Гвиана относится к первой группе. Самостоятельно оформить долгосрочную линию +594 нельзя; если она нужна вашей команде, напишите на [email protected], но доступность зависит от местных правил. Если вы сомневаетесь, к какой категории относится задача, поможет сравнение временных и выделенных номеров.

Как выглядит последовательность вызовов OTP API для Французской Гвианы?

Идентификатор страны для Французской Гвианы — gf. Используйте Bearer-ключ (префикс or_live_) и базовый адрес https://otproute.com/api/v1:

1. GET /api/v1/prices?country=gf&service=<id> возвращает актуальную цену и показывает, открыт ли маршрут.
2. POST /api/v1/activations с телом {"service": "facebook", "country": "gf"} резервирует номер +594 и возвращает идентификатор активации.
3. Ваш тест вводит номер в тестируемом приложении.
4. Код приходит через событие activation.sms_received на вебхук либо через GET /api/v1/activations/{id}, если вы используете опрос.
5. POST /api/v1/activations/{id}/cancel освобождает заказ, который тесту больше не нужен.

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

Почему номера +594 сбивают с толку валидацию телефонов?

Французская Гвиана — заморский регион Франции и использует французский план нумерации, но у неё собственный код страны +594, а не французский +33. Внутри страны номера состоят из десяти цифр с ведущим 0: мобильные обычно начинаются с 0694, стационарные — с 0594. В международном формате 0 отбрасывается, и мобильный номер превращается в +594 694 XX XX XX.

Из-за этого возникает несколько классических ошибок, и номер +594 для тестирования — самый простой способ их поймать:

• Выбор страны объединяет французские территории с Францией и добавляет +33 к номеру 0694.
• Телефонные библиотеки определяют регион как GF, а бизнес-логика знает только FR.
• Код отображения форматирует номер французскими парами цифр, но сохраняет отформатированную строку вместо E.164.

Храните +594… без пробелов и разделяйте в модели данных регион и страну как разные понятия.

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

На маршруте Французской Гвианы сейчас доступно более 700 сервисов. В актуальном срезе есть WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Snapchat, Telegram, Microsoft & Outlook, Amazon, Airbnb, Uber и LinkedIn.

Текст SMS обычно приходит на французском — на нём говорит большинство местных пользователей, — но сервисы сами выбирают шаблоны, поэтому извлекайте цифры, а не сопоставляйте фразу. Здесь тестируют, когда локализуют французские сценарии за пределами метрополии, обслуживают клиентов в заморских регионах Франции или проверяют, что региональный аккаунт по-прежнему проходит верификацию после изменения конфигурации.

Как заказать номер +594 из личного кабинета?

Код не нужен:

1. Зарегистрируйтесь по email и 6-значному коду из письма или через вход с Google и заодно включите двухфакторную защиту TOTP.
2. Пополните кошелёк картой или в USDT/USDC.
3. Выберите Французскую Гвиану и сервис; цена отображается до подтверждения.
4. Вставьте номер в приложение и следите за страницей активации, чтобы увидеть код.

Обычно так работают сотрудники операционных отделов и аккаунт-менеджеры агентств, пока инженеры подключают API. Все используют один и тот же кошелёк.

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

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

Если вы ждёте код на +594:

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

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

Как устроены оплата, счета и тестирование в песочнице?

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

Инженеры, настраивающие сценарий gf, могут попросить поддержку перевести тестовый аккаунт в режим песочницы. Он возвращает симулированные номера и коды, так что поток +594, проверку вебхука и логику повторов можно отработать от начала до конца, не тратя средства кошелька. С точки зрения API маршрутизация OTP во Французскую Гвиану ничем не отличается от любого другого рынка: меняется только идентификатор страны, а API SMS-верификации остаётся прежним.

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

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

Да. Закажите номер OTP Gateway для gf, введите его в форму регистрации и прочитайте код в личном кабинете или в своём вебхуке.

Номер Французской Гвианы — то же самое, что французский номер +33?

Нет. Французская Гвиана использует французский план нумерации, но у неё собственный код страны +594, а телефонные библиотеки считают её отдельным регионом.

Сколько стоит код на +594?

От $0.20 за код, в зависимости от сервиса; актуальную цену показывают личный кабинет и GET /api/v1/prices. Если SMS не пришло за 20 минут, деньги возвращаются автоматически.

Можно ли сохранить номер Французской Гвианы для повторных входов?

Самостоятельно оформить такой номер нельзя. Долгосрочные Dedicated Numbers доступны только в США и Канаде; по поводу +594 напишите на [email protected].

На каком языке приходят коды?

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

Можно ли протестировать интеграцию до пополнения кошелька?

Попросите включить режим песочницы для тестового аккаунта. Он имитирует номера и коды, так что вы сможете пройти весь сценарий, ничего не тратя.

Почему не пришёл код для Французской Гвианы?

Сервис мог задержаться, отклонить виртуальные номера, либо маршрут перегружен. Дождитесь конца окна, затем повторите позже или по другому маршруту; неудачные заказы возвращаются.

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