Чек-лист для получения кодов подтверждения Сен-Бартелеми (+590)

Чек-лист перед заказом номера +590

Сен-Бартелеми — один из самых небольших маршрутов OTP Route, поэтому небольшая подготовка избавит от напрасных попыток:

• Убедитесь, что сервис есть в списке сегодня. Вызовите GET /api/v1/countries и GET /api/v1/services или откройте панель; идентификатор страны — bl.
• Проверьте цену. GET /api/v1/prices?country=bl&service=<id> возвращает актуальное значение для этой пары.
• Пополните кошелёк, а для автоматических задач сначала проверьте GET /api/v1/balance.
• Подготовьте поле телефона так, чтобы оно принимало номер +590 с девятью цифрами после кода.
• Узнайте позицию сервиса по виртуальным номерам: некоторые их отвергают.
• Держите наготове запасной маршрут, поскольку покрытие здесь часто меняется.

Если вы только знакомитесь с моделью, основы объясняет материал о том, что такое OTP-шлюз.

Какие сервисы могут отправлять коды на номера Сен-Бартелеми?

Сейчас в маршруте указано более 20 сервисов — каталог гораздо короче, чем на крупных рынках. В актуальный снимок входят TikTok, Amazon, LinkedIn, AliExpress, Flipkart, Mercado Libre, Mercado Pago, Coinbase, Bumble и Swiggy.

Поскольку список короткий и меняется в течение дня, всегда читайте доступность из API в момент заказа. Если нужного сервиса нет, для франкоязычного тестового сценария могут подойти соседний маршрут Гваделупы, у которого тот же телефонный код +590, или маршрут Франции.

Пошагово: процесс Saint Barthelemy OTP routing через API

1. Аутентифицируйтесь на https://otproute.com/api/v1 с помощью Bearer-ключа, начинающегося с or_live_ (до 10 ключей на аккаунт, 300 запросов в минуту).
2. Оформите заказ: POST /api/v1/activations с телом {"service": "linkedin", "country": "bl"}. Сохраните идентификатор активации и полученный номер.
3. Введите номер +590 в приложении или на сайте, которые вы тестируете.
4. Заберите код +590 из события activation.sms_received либо опрашивайте GET /api/v1/activations/{id} каждые несколько секунд.
5. Проверьте заголовок X-OTPRoute-Signature вида t=<unix>,v1=<hex>: посчитайте HMAC-SHA256 от "<t>.<raw body>" с секретом эндпоинта и отклоняйте устаревшие метки времени.
6. Отмените заказ через POST /api/v1/activations/{id}/cancel, если тест закончился раньше.

В обзоре для разработчиков ключи, вебхуки и примеры собраны в одном месте.

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

Сен-Бартелеми использует код страны +590 вместе с Гваделупой и французской частью Сен-Мартена и следует французским правилам нумерации. Внутри страны номера записываются десятью цифрами с префиксом 0: городские обычно начинаются с 0590, а мобильные — с 0690. В E.164 0 отбрасывается, так что мобильный номер превращается в +590 690 и шесть цифр.

Одна деталь сбивает с толку многие команды: по телефонному коду одному нельзя понять, в какой территории живёт клиент. Если ваш продукт показывает региональный контент, спрашивайте территорию отдельно, а не выводите её из +590. Храните строку E.164 без пробелов, а территорию держите отдельным полем.

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

Зачем команде тестировать или работать в Сен-Бартелеми?

Экономика острова строится вокруг туризма, поэтому обычные причины — приложения для путешествий, аренды вилл, консьерж-сервисов, чартера яхт и гостеприимства. Командам нужно убедиться, что гость или местный сотрудник с номером +590 может завершить регистрацию, а агентства, ведущие карибские кампании для отелей, иногда верифицируют там бизнес-профили клиентов. Ещё одна причина — QA локализации франкоязычных сценариев в Карибском регионе; этот случай описан на странице для операционных команд.

Устранение неполадок: код не пришёл

Каждая активация открыта 20 минут, а платить нужно только если код пришёл. Окно, закрывшееся впустую, или отменённый заказ автоматически возвращают всю сумму на кошелёк, а ваш вебхук получает activation.expired или activation.cancelled.

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

Путь без кода: зарегистрируйтесь с помощью электронной почты и 6-значного кода из письма или через Google, включите TOTP, пополните баланс, выберите Сен-Бартелеми и сервис, примите показанную цену и прочитайте код в панели.

Долгосрочные линии, оплата и песочница

В Сен-Бартелеми нет самообслуживаемого долгосрочного номера. Выделенные линии — продукт для США и Канады, от $1.95/месяц; для постоянной линии +590 напишите на [email protected], хотя доступность зависит от местных правил и не гарантируется.

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

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

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

Можно ли получить код подтверждения Сен-Бартелеми без местной SIM-карты?

Да, если сервис в этот момент есть на маршруте. Закажите номер +590 в OTP Gateway и прочитайте код в панели или через API.

Какой идентификатор страны для Сен-Бартелеми в API?

Это bl, поэтому тело заказа выглядит как {"service": "tiktok", "country": "bl"}.

Почему список сервисов для Сен-Бартелеми такой короткий?

Это небольшой маршрут, и покрытие часто меняется. Проверьте актуальный список через GET /api/v1/countries или в панели и рассмотрите Гваделупу либо Францию как альтернативы.

Всегда ли +590 означает, что клиент находится в Сен-Бартелеми?

Нет. Гваделупа и французская часть Сен-Мартена используют тот же +590, поэтому, если это важно для вашего продукта, собирайте территорию отдельно.

Сколько стоит номер +590 для тестирования?

От $0.20 за код; точную сумму определяет сервис, и API возвращает её в реальном времени перед заказом.

Потеряю ли я деньги, если код не придёт?

Нет. Через 20 минут без SMS или при отмене вся сумма возвращается на ваш кошелёк.

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

Не в режиме самообслуживания. Выделенные номера доступны только в США и Канаде; о других вариантах спросите по адресу [email protected].

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