Как получать коды верификации Венесуэлы (+58) в вашем наборе тестов

Почему ведущий 0 вызывает ошибки с номерами Венесуэлы?

Код страны Венесуэлы — +58, а внутри страны номера записываются с транковым префиксом 0. Мобильные номера при наборе внутри страны выглядят как 0412, 0414, 0416, 0424 или 0426 и ещё семь цифр. В формате E.164 этот ноль пропадает: 0414 123 4567 превращается в +584141234567.

Классический дефект — форма, которая просто дописывает +58 к тому, что ввёл пользователь, и получается +580414…, который не примет ни один сервис. Защититься можно так:

• удалять один ведущий 0, если выбрана Венесуэла, до добавления кода страны;
• хранить только нормализованную строку E.164, а форматировать для показа уже при отрисовке;
• добавить тест, который вводит локальную форму номера и проверяет сохранённое значение.

Номер +58 из OTP Gateway для тестов приходит сразу в международном формате, поэтому его удобно использовать как эталон в таких проверках.

Что проверить при локализационном QA для пользователей из Венесуэлы?

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

Со своей стороны проверьте испаноязычные тексты (латиноамериканский вариант) на экранах ввода номера и кода, сообщения об ошибке для неверного номера и текст таймера повторной отправки. Именно эти строки пользователь читает в тот момент, когда вероятность бросить регистрацию выше всего.

Где номера Венесуэлы важны для продуктовой команды?

У Венесуэлы большая диаспора в Латинской Америке, Испании и США, и многие сохраняют SIM-карту с номером +58 после переезда. Поэтому венесуэльские номера важны далеко за пределами самой страны:

• Трансграничные регистрации: пользователь регистрируется за рубежом с домашним номером, и определение страны в вашем продукте не должно его отклонять.
• Поддержка через мессенджеры: чаты — основной способ связи с бизнесом, и команды проверяют настройку бизнес-аккаунтов WhatsApp и Telegram именно так.
• Региональные запуски в Южной Америке, где в чек-листе релиза нужен хотя бы один реалистичный сценарий с +58.
• Агентства, которые ведут соцсети венесуэльских брендов и хотят, чтобы коды приходили в общий инструмент, а не на личный телефон менеджера; см. агентства и реселлеры.

Что OTP Gateway покрывает для Венесуэлы?

На венесуэльских номерах доступно более 1 700 сервисов. Среди часто запрашиваемых — WhatsApp, Telegram, Google (Gmail и YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft и Outlook, Amazon, Discord и LinkedIn. Воспринимайте этот список как моментальный снимок: доступность по каждой паре «сервис — страна» пересчитывается в течение дня, и API всегда отдаёт её в реальном времени.

Как вызвать API OTP для Венесуэлы из тестового раннера?

Все запросы идут на https://otproute.com/api/v1 с Bearer-ключом, имеющим префикс or_live_. Создавайте по одному ключу на окружение в консоли разработчика (лимит — 10 ключей). Идентификатор страны для Венесуэлы — ve.

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

В начале набора тестов проверяйте GET /api/v1/balance. Для вебхуков проверяйте X-OTPRoute-Signature (t=<unix>,v1=<hex>): вычислите HMAC-SHA256 от <t>.<raw body> с секретом endpoint и отклоняйте устаревшие метки времени. На аккаунте допускается 5 вебхук-endpoint и 300 запросов в минуту. Подходы к пайплайнам описаны в статье тестирование SMS OTP в CI-пайплайнах и в документации API.

Ручной заказ и что делать, если код не приходит

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

У каждой активации есть окно в 20 минут. Если SMS не пришло за это время или вы отменили активацию, вся сумма автоматически возвращается на кошелёк: вы платите только за полученные коды. Скорость зависит от сервиса и маршрута. Если код задерживается, дождитесь окончания окна, затем повторите позже или выберите другой маршрут сервиса, не перезаказывая номер в цикле. Проверьте, не отклоняет ли сервис виртуальные номера для этого действия, — некоторые так делают. Соблюдайте условия каждого сервиса; на всё это распространяется Политика допустимого использования OTP Route.

Можно ли оставить номер +58 за собой и как пополняется кошелёк?

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

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

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

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

Да. Закажите номер +58 в OTP Gateway, введите его в приложении, и код появится в панели или придёт на ваш вебхук.

Какой идентификатор у Венесуэлы в API OTP Route?

ve. Используйте его в GET /api/v1/prices и как значение country при создании активации.

Нужно ли хранить 0 в венесуэльском мобильном номере?

Нет. Отбросьте внутренний транковый 0 и храните +58 и остальные цифры, например +58414, а затем ещё семь цифр.

Сколько стоит номер для верификации в Венесуэле?

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

Почему мой венесуэльский код пришёл на английском?

Язык выбирает отправляющий сервис, обычно по локали аккаунта или устройства. Разбирайте цифры, а не полагайтесь на текст сообщения.

Есть ли выделенный долгосрочный номер для Венесуэлы?

Самостоятельного варианта нет; выделенные линии — это продукт для США и Канады. Узнать о Венесуэле можно, написав на [email protected].

Можно ли использовать OTP Route, чтобы обойти ограничения платформы?

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

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