Тестируем регистрацию в Доминиканской Республике: чек-лист и пошаговое руководство

Что должно быть в чек-листе перед заказом доминиканского номера?

Большинство неудачных тестовых прогонов на новом рынке объясняются настройкой, а не маршрутом. Отметьте эти пункты до первой активации:

• Идентификатор сервиса для тестируемого приложения, взятый из GET /api/v1/services.
• Идентификатор страны do, подтверждённый через GET /api/v1/countries.
• Актуальная цена этой пары из GET /api/v1/prices?country=do&service=<id>, чтобы тестовый бюджет был известен заранее.
• Баланс кошелька, проверенный через GET /api/v1/balance, чтобы CI-задача не застряла на полпути.
• Эндпоинт вебхука, зарегистрированный в консоли разработчика, с секретом подписи в вашем менеджере секретов.
• Парсер телефонов, настроенный так, чтобы считать номер регионом DO, а не обычной линией +1.
• Испанские тексты в ваших собственных шаблонах верификации, проверенные заранее, если вы сами отправляете коды доминиканским пользователям.

Руководство по QA-тестированию подробнее описывает, как команды составляют такие предполётные списки.

Как форматировать и хранить телефонные номера Доминиканской Республики?

Доминиканская Республика входит в Североамериканский план нумерации, поэтому её номера используют код страны +1 вместе с США, Канадой и значительной частью Карибского региона. Страну обслуживают три кода региона: 809, 829 и 849. Полный номер — десять цифр после +1, а префикса междугородной связи 0, который нужно отбрасывать, нет.

Именно этот общий префикс подводит инженеров. Валидатор, который сопоставляет каждый номер +1 с США, неверно определит доминиканских пользователей, применит не ту локаль, а иногда направит их в не ту очередь поддержки. Храните номера в формате E.164 (+1809…, +1829…, +1849…), сохраняйте рядом с каждой записью ISO-регион DO и определяйте страну по коду региона, а не только по коду страны. Когда пользователь вводит местный формат вроде 809-555-0100, нормализуйте его при вводе и показывайте обратно в национальном стиле.

Зачем продуктовым командам тестировать номер +1 для Доминиканской Республики?

Официальный язык — испанский, поэтому доминиканский тестовый прогон часто становится первой настоящей проверкой испаноязычного онбординга за пределами Испании и Мексики. Причин несколько:

• Запуски в Карибском регионе: убедиться, что экран регистрации, текст согласия и сообщения об ошибках корректно читаются для доминиканских пользователей.
• Диаспора: многие доминиканцы живут в США, и приложения, обслуживающие обе стороны, должны принимать оба вида номеров +1.
• Гостиничные и туристические операции: туризм — важная часть экономики, поэтому приложения для бронирования и поездок здесь тестируют часто.
• Язык сообщений: глобальные сервисы обычно локализуют SMS по языку аккаунта или устройства, а местные отправители чаще пишут по-испански. Ваша логика извлечения должна читать цифры и не зависеть от окружающих слов.

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

В живом срезе для do указаны такие популярные приложения, как WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Uber, Airbnb, Amazon, Microsoft & Outlook, Discord, Signal, Netflix и eBay. По всему каталогу маршрут охватывает более 1 000 сервисов.

Доступность для любой пары меняется в течение дня, пока наши операторы-партнёры добавляют и расходуют ёмкость. Считайте список выше ориентиром и доверяйте API: GET /api/v1/prices возвращает только то, что действительно можно заказать прямо сейчас.

Шаг за шагом: получение SMS OTP Доминиканской Республики через API

1. Авторизуйте каждый вызов Bearer-ключом, начинающимся с or_live_; в аккаунте может быть до 10 ключей.
2. Отправьте POST /api/v1/activations с телом {"service": "<id>", "country": "do"}. В ответе придут идентификатор активации и номер +1.
3. Введите этот номер в форму регистрации тестируемого приложения.
4. Ждите activation.sms_received на вашем вебхуке. Проверьте заголовок X-OTPRoute-Signature: вычислите HMAC-SHA256 от метки времени, точки и сырого тела запроса с секретом эндпоинта и отклоняйте устаревшие метки.
5. Если нельзя открыть публичный эндпоинт, вместо этого опрашивайте GET /api/v1/activations/{id}, не превышая лимит 300 запросов в минуту.
6. Если тест прерван, вызовите POST /api/v1/activations/{id}/cancel, чтобы средства сразу вернулись.

Справочник API перечисляет все поля, а статья о защите вебхуков OTP с помощью HMAC подробнее разбирает проверку подписи.

Шаг за шагом: путь через панель для тех, кто не пишет код

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

Устранение неполадок, долгосрочные линии и оплата

Если код не появился, пройдите по этому списку, прежде чем заказывать снова:

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

Самостоятельно оформляемого долгосрочного доминиканского номера нет. Если вам нужна линия, которая остаётся у вас, напишите на [email protected]; возможность зависит от местных правил. Выделенные линии — продукт для США и Канады от $1.95/month.

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

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

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

Да. Закажите номер +1 для страны do через OTP Gateway и прочитайте код в панели или через API — ни SIM-карта, ни телефон не нужны.

Какие коды региона используют доминиканские номера?

Доминиканские номера используют коды региона 809, 829 и 849 с кодом страны +1. Храните их в формате E.164 и сохраняйте рядом с записью регион DO.

Сколько стоит проверочный номер Доминиканской Республики?

Доминиканские активации начинаются от $0.20 за код, и сумма различается от приложения к приложению. Точную сумму GET /api/v1/prices возвращает до размещения заказа.

Спишутся ли деньги, если SMS не придёт?

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

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

Самостоятельно — нет; каждый временный номер принимает один код. Напишите на [email protected], чтобы узнать о долгосрочных вариантах, которые зависят от местных правил.

Подходит ли OTP Route для автоматизированных наборов тестов?

Да. REST-эндпоинты, подписанные вебхуки и необязательный тестовый аккаунт в режиме песочницы позволяют CI-задачам проверять доминиканскую регистрацию от начала до конца. Соблюдайте условия каждого приложения и Политику допустимого использования OTP Route.

Приходят ли доминиканские проверочные сообщения на испанском?

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

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