Доставляем эквадорские (+593) коды подтверждения в ваши тестовые прогоны

Почему наша регистрация в Эквадоре застряла в ожидании телефона?

Картина знакомая. Продуктовая команда добавляет Эквадор в список запусков, экран регистрации просит мобильный +593, а у QA такого номера нет ни у кого. Кто-то заказывает предоплаченную SIM-карту, она лежит в ящике в другом городе, и каждый регрессионный прогон теперь зависит от коллеги, который зачитывает коды вслух в чате.

Такая схема ломается, как только тесты идут ночью или параллельно. К тому же она выпускает коды туда, куда им попадать нельзя. OTP Route заменяет SIM-карту из ящика OTP-маршрутизацией через API: ваш тест запрашивает эквадорский номер, проверочное SMS приходит на нашу сторону, а код возвращается задаче, которая его запросила. Никому не нужно бодрствовать, и ничей личный телефон не задействован.

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

Эквадорский маршрут сейчас охватывает более 1 700 сервисов. Среди популярных в живом срезе — WhatsApp, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), LinkedIn, Microsoft & Outlook, Uber, Airbnb, Netflix, Discord и ChatGPT (OpenAI).

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

Как выглядит последовательность вызовов Ecuador OTP API в коде?

Всё находится под https://otproute.com/api/v1 и авторизуется Bearer-ключом с префиксом or_live_, созданным в консоли разработчика. Типичный шаг теста выглядит так:

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

Доставки вебхуков несут заголовок X-OTPRoute-Signature. Пересчитайте HMAC-SHA256 от метки времени, точки и сырого тела запроса с секретом эндпоинта, сравнивайте за постоянное время и отклоняйте устаревшие метки. Руководство по интеграции разбирает полный клиент API SMS-верификации, а документация перечисляет все поля.

Как хранить в базе мобильные номера +593?

Эквадорцы обычно записывают мобильный номер с ведущим 0, например 09 и ещё восемь цифр. Этот ноль — префикс междугородной связи, который используется только при внутренних звонках. В формате E.164 он исчезает, остаются +593 и девятизначный национальный номер, начинающийся с 9.

• Храните одну каноническую форму: +5939XXXXXXXX. При вводе убирайте пробелы, дефисы и ноль префикса.
• Принимайте в поле формы и 09…, и +593 9…, поскольку местные жители вводят оба варианта.
• Не предполагайте английский язык в шаблонах сообщений. Официальный язык Эквадора — испанский, поэтому большинство кодов приходит в испанском тексте; извлекайте цифры, а не ищите слова вроде «code».

Небольшое удобство для тестов оплаты: валюта Эквадора — доллар США, что совпадает с долларовым кошельком, который вы пополняете в OTP Route.

Код в Эквадоре не пришёл. Что делать?

Молчащий номер — это обычно вопрос маршрута или принятия номера сервисом, а не ошибка вашей обвязки. Действуйте в таком порядке:

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

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

Можно ли оставить эквадорский номер для аккаунтов, которые входят повторно?

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

Как тарифицируются коды Эквадора и можно ли сначала проверить бесплатно?

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

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

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

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

Да. Закажите активацию для идентификатора страны ec, введите номер +593 в приложение и прочитайте код в панели, на вебхуке или при опросе.

Сколько стоит эквадорский проверочный код?

Коды стоят от $0.20 за код; точная сумма зависит от сервиса и показывается в панели или возвращается эндпоинтом цен до заказа.

Плачу ли я, если на номер +593 не пришло SMS?

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

Нужно ли отправлять ведущий ноль при вводе эквадорского номера?

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

На каком языке будут эквадорские OTP-сообщения?

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

Есть ли номер +593 для тестов, который можно держать месяцами?

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

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

Да. Войдите, выберите сервис и Эквадор в OTP Gateway, подтвердите показанную цену, и код появится на том же экране, когда придёт.

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