Коды подтверждения Сальвадора (+503) для QA и команд запуска

Одноразовый код или долгосрочная линия: что нужно сальвадорскому тесту?

Начните с формы теста, потому что она определяет продукт.

• Один шаг верификации (регистрация, смена телефона, дополнительная проверка) соответствует OTP Gateway. Вы заказываете номер +503 для одного сервиса, код приходит один раз, и номер отработал.
• Аккаунту, который должен входить снова на протяжении недель, нужна собственная линия. Выделенные номера — продукт для США и Канады от $1.95/month, покупаемый мгновенно в панели, с входящими и исходящими SMS и звонками из браузера.

Самостоятельно оформляемого выделенного номера для Сальвадора нет. Если вашей команде действительно нужна долгосрочная сальвадорская линия, напишите на [email protected]; возможность зависит от местных правил и не гарантируется. Многие команды решают сценарий «повторный вход» американской линией, если тестируемый сервис её принимает. Для запуска в Сальвадоре взвесьте оба пути с помощью заметок о временных и выделенных номерах.

Как хранить и проверять номера +503?

В Сальвадоре действует закрытый 8-значный план нумерации без префикса междугородной связи. Номер, который местный житель пишет в форме, — те же 8 цифр, что следуют за +503 в международной записи, поэтому нормализация в основном сводится к удалению знаков препинания: мобильные номера местные часто пишут двумя блоками по четыре цифры через дефис.

• Храните форму E.164, +503 и восемь цифр, в одной колонке.
• Мобильные номера обычно начинаются с 6 или 7; стационарные — как правило, с 2. Валидатор, принимающий только такие первые цифры, ловит большинство опечаток.
• Отклоняйте лишний ведущий 0. Пользователи, привыкшие к другим латиноамериканским планам, иногда его добавляют, и некоторые SMS-платформы молча отбрасывают сообщение.

Шаблоны SMS вашего приложения для этого рынка обычно испаноязычные. Символы вроде á, í или ó находятся вне базового алфавита GSM, поэтому шаблон с ними может переключиться на кодировку UCS-2 и сократить каждый сегмент. Размещайте код ближе к началу сообщения, чтобы он пережил разбиение.

Зачем команды тестируют регистрацию в Сальвадоре?

Несколько сценариев повторяются постоянно:

• Запуски в Центральной Америке. Продукт, выходящий в Гватемале, Гондурасе и Сальвадоре, хочет проверить телефонный шаг каждой страны до запуска рекламы.
• Диаспора. Многие сальвадорцы живут в США и сохраняют номер +503 для семьи, поэтому сервисы денежных переводов, платежей и обмена сообщениями видят сальвадорские номера, даже если адрес пользователя американский. Об этом сценарии — в материале об онбординге в финтехе.
• QA локализации. Испанские тексты, селектор страны и маски номеров требуют настоящего сальвадорского кода, чтобы подтвердить работу экранов от начала до конца.
• Цены в долларах США. Доллар США — официальная валюта Сальвадора, что делает рынок удобным местом для совместной проверки оплаты и онбординга.

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

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

1. Получите GET /api/v1/countries и GET /api/v1/services и закэшируйте идентификаторы.
2. Прочитайте актуальную цену через GET /api/v1/prices?country=sv&service=<id>; она же показывает, доступен ли маршрут прямо сейчас.
3. Создайте заказ через POST /api/v1/activations с телом вроде {"service": "telegram", "country": "sv"}. Сохраните идентификатор активации и номер.
4. Пусть сальвадорская сборка вашего приложения отправит проверочное SMS на этот номер.
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 от метки времени, точки и сырого тела запроса с секретом вашего эндпоинта. Проверяйте его и отбрасывайте устаревшие метки; как это делать, разбирает материал о защите вебхуков OTP. Не-разработчики могут сделать то же самое из панели: выберите Сальвадор, выберите сервис, подтвердите актуальную цену и наблюдайте, как код появляется на карточке активации.

Какие сервисы можно подтвердить на сальвадорском номере?

В живом срезе указано более 900 сервисов с маршрутами Сальвадора. Среди популярных — WhatsApp, Facebook, Instagram, TikTok, Uber, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Telegram, Signal, LinkedIn и ChatGPT (OpenAI). Наличие меняется в течение дня, поэтому ваш тестовый раннер должен опираться на эндпоинт цен, а не на фиксированный список.

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

Что делать, если сальвадорский код не пришёл?

Медленный код +503 — ещё не неудачный, поэтому оставляйте заказ открытым все 20 минут. Если ничего не пришло, заказ истекает, срабатывает activation.expired, и вся сумма автоматически возвращается в кошелёк. Затем:

• проверьте, принимает ли сервис виртуальные номера для такого шага;
• повторите позже или выберите другой маршрут сервиса, а не заказывайте заново в плотном цикле;
• убедитесь, что ваше приложение действительно отправило SMS именно на возвращённый номер в формате E.164.

Дополнительные советы по устранению неполадок, удобные для Центральной Америки, есть в материале о том, как снизить число недоставленных OTP.

Как устроена оплата заказов для Сальвадора?

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

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

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

Да. Закажите номер +503 в OTP Gateway для тестируемого сервиса, запустите отправку SMS и прочитайте код в панели или через API.

Есть ли у сальвадорских номеров префикс междугородной связи, например 0?

Нет. Номера Сальвадора состоят из восьми цифр без префикса, поэтому международная форма — просто +503 и эти восемь цифр.

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

Используйте sv в запросах цен и в теле активации, например GET /api/v1/prices?country=sv&service=<id>.

Спишутся ли деньги, если на номер +503 не пришёл код?

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

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

Как самостоятельный продукт — нет. Долгосрочные выделенные номера предлагаются в США и Канаде; по Сальвадору можно написать на [email protected], без обещания доступности.

OTP Route предназначен для создания множества аккаунтов?

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

Можно ли запускать сальвадорский сценарий в CI, не тратя деньги?

Да. Тестовый аккаунт по запросу можно перевести в песочницу: она возвращает имитированные номера и коды, так что ваш конвейер может прогнать весь путь через API.

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