Проверочные номера Гаити (+509) для продуктовых команд и QA

Зачем продуктовой команде тестировать гаитянский номер?

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

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

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

Гаитянские номера содержат восемь цифр после кода страны +509. Транковой приставки при внутренних звонках нет, поэтому местная форма — просто эти восемь цифр, а международная добавляет впереди +509.

Храните каноническое значение в E.164 (+509 и восемь цифр) и удаляйте при вводе пробелы, дефисы и ведущий 00509. Учитывайте и поведение диаспоры: гаитянский клиент, живущий за границей, может зарегистрироваться с американским или канадским номером, а позже добавить линию +509, поэтому выбор страны и проверки на дубликаты должны считать код страны частью идентичности, а не украшением.

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

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

Маршрут +509 сейчас предлагает более 1 000 сервисов. В актуальном срезе — WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, TikTok, X (Twitter), Snapchat, Signal, Viber, Amazon, Netflix и eBay.

Считайте эти названия примерами того, что обычно обрабатывают номера +509, а не фиксированным меню. Наличие меняется в течение дня, поэтому API и панель показывают, что открыто на момент вашего запроса. Некоторые сервисы также отказывают виртуальным номерам, и автоматический возврат существует именно для такого случая. Названия сервисов принадлежат их владельцам; никакой связи между ними и этим продуктом нет.

Вызов Haiti OTP API с id страны `ht`

Разработчики получают доступ к тому же ресурсу по REST. Авторизуйтесь Bearer-ключом из консоли разработчика (префикс or_live_) на https://otproute.com/api/v1, затем:

1. Получите список сервисов через GET /api/v1/services, а чтобы подтвердить охват — список стран через GET /api/v1/countries.
2. Узнайте актуальную цену через GET /api/v1/prices?country=ht&service=<id>.
3. Оформите заказ через POST /api/v1/activations, отправив {"service": "<id>", "country": "ht"}.
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 от метки времени и сырого тела с секретом эндпоинта, отбрасывайте события со старыми метками времени и сделайте обработчик идемпотентным по id активации. Руководство по интеграции API подробнее показывает этот поток OTP-маршрутизации. Рассчитывайте скрипты примерно на 300 запросов в минуту на аккаунт.

Получение кода +509 из панели

Сотрудники поддержки и операционных команд могут вообще обойтись без API. Откройте OTP Gateway в своей панели, выберите Гаити и сервис и посмотрите цену, показанную перед заказом. После подтверждения вы получите номер +509 для тестирования; вставьте его в приложение, запросите SMS и следите за кодом на карточке заказа. Номер принадлежит только этой одной проверке и закрывается по окончании её 20-минутного окна.

Кода пока нет? Диагностика маршрута Гаити

У молчания на заказе +509 обычно несколько простых причин:

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

Если окно закрылось пустым или вы отменили заказ, вся сумма автоматически возвращается на кошелёк, так что неудачная попытка ничего не стоит. Больше приёмов собрано в материале о снижении числа неудачных доставок OTP.

Долгосрочные линии, кошелёк и песочница для работы с Гаити

OTP Route не продаёт долгосрочные гаитянские номера по самообслуживанию. Выделенные виртуальные номера, которые остаются за вами, пока продлеваются, — это продукт для США и Канады от $1.95/месяц, и они могут стать удачным дополнением для линий поддержки диаспоры на североамериканской стороне. Если вам нужна именно долгосрочная линия +509, напишите на [email protected]; команда изучит вопрос, но решают местные правила, и ничего не обещается.

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

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

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

Да. Закажите номер +509 в OTP Gateway от OTP Route, запустите отправку SMS в приложении и прочитайте код в панели или через вебхук.

Какой id страны использует API для Гаити?

Это ht. Сочетайте его с id сервиса, например POST /api/v1/activations с {"service": "telegram", "country": "ht"}.

Сколько сервисов работает с проверочным номером Гаити?

Более 1 000 на момент последнего среза. Точный список меняется в течение дня, поэтому проверьте GET /api/v1/prices или панель перед заказом.

Нужно ли платить, если код +509 не пришёл?

Нет. Если 20-минутное окно прошло без SMS или вы отменили активацию раньше, вся сумма автоматически возвращается на кошелёк.

Придут ли коды на гаитянском креольском?

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

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

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

Какими способами можно пополнить кошелёк?

Картой и стейблкоинами USDT или USDC, с зачислением на предоплаченный кошелёк в USD. Абонентской платы и тарифов для выбора нет.

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