Одноразовый или долгосрочный номер? Выбираем маршрут +1 787 для тестов верификации

Что выбрать для проекта в Пуэрто-Рико: OTP Gateway или Dedicated Number?

Начните с вопроса, как долго должен жить номер. OTP Gateway выдаёт номер +1 787 ровно для одного кода — это подходит для теста регистрации, проверки локализации или CI-задачи, которая один раз верифицируется и идёт дальше. Dedicated Number — это линия, которую вы сохраняете за собой: она годится для staging-аккаунта, в который нужно войти снова через неделю, или для общего ящика поддержки.

Для Пуэрто-Рико выбор по сути уже сделан за вас. Хотя остров — территория США, его номеров нет в самообслуживаемом каталоге Dedicated Number: этот продукт охватывает США и Канаду, от $1.95/месяц. Если для постоянного аккаунта подойдёт линия в континентальных США, варианты описаны на странице виртуальных номеров. Если вам нужна именно долгосрочная пуэрториканская линия, напишите на [email protected]; возможность её оформить зависит от местных правил и не гарантируется.

Какие вызовы API для Пуэрто-Рико создают и читают активацию?

API находится по адресу https://otproute.com/api/v1 и ожидает Bearer-ключи с префиксом or_live_. Идентификатор страны для Пуэрто-Рико — pr.

1. Получите идентификаторы через GET /api/v1/services и GET /api/v1/countries и кэшируйте их на время развёртывания.
2. Узнайте цену: GET /api/v1/prices?country=pr&service=<id> возвращает текущую стоимость и показывает, открыт ли маршрут.
3. Закажите номер через POST /api/v1/activations с телом {"service": "<id>", "country": "pr"}.
4. Подставьте полученный номер в тестируемый сценарий.
5. Получите код событием activation.sms_received на вебхук или опросом GET /api/v1/activations/{id}.
6. Если задача завершилась раньше, отмените заказ через POST /api/v1/activations/{id}/cancel.

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

Чем неудобны номера +1 787 и +1 939 в формах?

Пуэрто-Рико входит в Североамериканский план нумерации, поэтому его номера выглядят как любые номера США: код страны 1, трёхзначный код региона (787 или дополнительный 939) и семь цифр; в формате E.164 это +1787 или +1939 плюс семь цифр.

Это сходство порождает вполне реальные ошибки. Одни приложения выделяют Пуэрто-Рико в отдельную страну с ISO-кодом PR, другие объединяют его с США, а формы адреса могут ожидать PR в качестве значения штата. Проверьте, что выбор страны, валидатор телефона и поля адреса согласованы между собой и что пользователю, выбравшему Пуэрто-Рико, никогда не говорят, что его номер +1 недействителен. Храните номера в E.164, а регион определяйте по коду региона, а не по начальному +1.

Какие сервисы могут получать SMS-коды в Пуэрто-Рико?

Сейчас на маршруте Пуэрто-Рико доступно более 900 сервисов. Среди популярных отправителей — WhatsApp, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Amazon, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Discord, Airbnb, Netflix и Telegram. Доступность меняется в течение дня, поэтому в момент заказа доверяйте ответу API, а не любому списку.

Без кода всё делается так: откройте OTP Gateway в панели, выберите Пуэрто-Рико и сервис, подтвердите показанную цену и сделайте заказ. Номер для верификации в Пуэрто-Рико появится с обратным отсчётом, а код отобразится рядом, когда придёт SMS.

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

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

Если пуэрториканские коды не доходят:

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

О более общих сценариях читайте в материале как снизить число недоставленных OTP.

Зачем проверять испанский и английский сценарии для Пуэрто-Рико?

Испанский и английский — официальные языки, причём испанский большинство жителей использует каждый день. Поэтому Пуэрто-Рико удобно для проверки двуязычного онбординга: приходит ли SMS с кодом на испанском, когда в приложении выбран испанский; корректно ли экран ввода кода обрабатывает тексты с диакритикой; уходит ли нужный шаблон, если пользователь переключает язык посреди сценария? Остров использует доллар США, и многие американские компании уже работают там, поэтому платёжным приложениям, службам доставки, маркетплейсам и банкам, расширяющим запуск в США, часто нужен номер +1 787 для тестирования. Проводите такие проверки на аккаунтах, которые вы контролируете, соблюдайте условия каждого сервиса и придерживайтесь Политики допустимого использования OTP Route. Чтобы автоматизировать их, см. тестирование в CI/CD.

Как работают кошелёк и песочница при тестах для Пуэрто-Рико?

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

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

Можно ли протестировать регистрацию в Пуэрто-Рико без местной SIM-карты?

Да. Закажите номер +1 787 в OTP Gateway, введите его в приложении и заберите код в панели или через API для SMS-верификации и вебхуки.

Считается ли Пуэрто-Рико в API частью США?

Нет. У него собственный идентификатор страны pr, который используется в запросах цен и активации вместо идентификатора США.

Можно ли купить Dedicated Number +1 787?

Не через панель. Самообслуживаемые Dedicated Numbers охватывают только США и Канаду; чтобы узнать о пуэрториканской линии, напишите на [email protected].

Придёт ли проверочное SMS на испанском?

Это зависит от отправителя и часто от языковой настройки приложения. Если ваш продукт поддерживает оба языка, проверьте испанскую и английскую локали.

Какие коды региона могут встретиться в номере Пуэрто-Рико?

Пуэрто-Рико использует 787 и 939. Какой бы код вы ни получили, храните номер в E.164, чтобы записи оставались согласованными.

Сколько стоит код подтверждения в Пуэрто-Рико?

От $0.20 за код. Точная цена для каждого сервиса приходит из GET /api/v1/prices и отображается в панели; если код так и не придёт, плата не списывается.

Сколько параллельных тестов можно запускать?

Аккаунт допускает 300 запросов в минуту и 10 ключей. Основная часть этого бюджета уходит на опрос, поэтому вебхуки оставляют больше запаса для параллельных задач.

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