Как получать коды подтверждения +239 из Сан-Томе и Принсипи

Зачем продуктовой команде тестировать в Сан-Томе и Принсипи?

Острова — один из самых маленьких рынков Африки, но они важны для любого продукта, рассчитанного на португалоязычный мир. Командам, которые запускаются в лузофонной Африке или поддерживают клиентов, переезжающих между островами, Португалией и Анголой, нужно убедиться, что номер +239 проходит форму регистрации, а португальские тексты читаются правильно.

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

Есть и практические причины. НКО, агентствам развития и удалённым работодателям с сотрудниками на острове Сан-Томе или Принсипи часто нужно проверить, что онбординг работает на местных номерах, а финтех-командам, расширяющим коридоры переводов из Португалии, — получить доказательство, что клиент с номером +239 может завершить регистрацию. Прогон QA с настоящим островным номером отвечает на этот вопрос быстрее, чем обращение в поддержку от растерянного пользователя.

Как записывать и хранить номер +239?

Национальные номера состоят из семи цифр, а мобильные обычно начинаются с 9. В формате E.164 это +239 и семь цифр. Такие короткие номера ломают валидаторы, ожидающие минимум восемь цифр, поэтому добавьте в тесты разбора случай с +239 и перед сохранением убирайте пробелы и дефисы.

Несколько привычек помогают держать данные в порядке:

• Сохраняйте каноническую строку +239, а определённую страну храните в отдельном столбце.
• Убирайте международный префикс 00239, если пользователь вставляет номер из старой карточки контакта.
• Не дополняйте семизначные номера до фиксированной длины поля в базе — лучше расширьте само поле.
• Включите хотя бы одну фикстуру с +239 в модульные тесты, чтобы будущее изменение валидатора не сломало её незаметно.

Что OTP Gateway предлагает для Сан-Томе и Принсипи?

В актуальном каталоге страны более 600 сервисов. Среди популярных — WhatsApp, Telegram, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, Discord, LinkedIn, Signal, Viber, imo и Amazon.

На небольшом рынке покрытие в отдельные часы может сокращаться. Перед каждым заказом читайте GET /api/v1/prices, а не полагайтесь на вчерашние результаты, и если маршрут пуст, сравните его с близким португалоязычным, например Кабо-Верде, или с более крупным, например Анголой.

Как выглядит работа через API для идентификатора страны st?

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

Запросы идут на https://otproute.com/api/v1 с Bearer-ключом or_live_. Проверяйте X-OTPRoute-Signature (HMAC-SHA256 от "<t>.<raw body>") и отбрасывайте старые метки времени; как это сделать, показано в статье защита вебхуков OTP с помощью HMAC.

Можно ли пользоваться сервисом без доступа к коду?

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

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

Что с долгосрочным номером, оплатой и песочницей?

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

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

Поскольку кошелёк общий для всех стран, команда, которая тестирует острова вместе с Португалией или Бразилией, видит все эти активации на одном балансе и в одном наборе счетов, а это упрощает сверку для бухгалтерии в конце месяца.

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

Можно ли проверить регистрацию в моём приложении для Сан-Томе и Принсипи, не бывая на островах?

Да. Закажите номер +239 в OTP Gateway от OTP Route, введите его в приложении и прочитайте код в панели или через API.

Что делать, если код +239 не приходит?

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

Спишут ли деньги за неудавшуюся активацию в Сан-Томе и Принсипи?

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

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

Некоторые сервисы не принимают виртуальные номера. Это не зависит от OTP Route, поэтому неиспользованные активации возвращаются.

Будет ли проверочное сообщение на португальском?

Часто да, так как это официальный язык, но каждое приложение само выбирает текст и может использовать английский.

Есть ли ограничения по частоте в OTP API для Сан-Томе и Принсипи?

На каждый аккаунт приходится 300 запросов в минуту, до 10 API-ключей и 5 эндпоинтов вебхуков.

Можно ли запускать это в задаче CI?

Да, заказывая по одной активации за прогон. На странице QA-тестирование описано, как команды это организуют.

Какое использование разрешает OTP Route?

Тестирование вашего собственного продукта и работу с легитимными бизнес-аккаунтами в рамках условий каждого сервиса и правил допустимого использования OTP Route.

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