Как получать коды подтверждения из Аргентины (+54) в вашей интеграции

Какие четыре вызова API стоят за активацией номера +54?

Всё находится по адресу https://otproute.com/api/v1 и авторизуется Bearer-ключом с префиксом or_live_. Ключи выдаются в консоли разработчика; в аккаунте может быть до 10 ключей и 5 эндпоинтов вебхуков, при лимите 300 запросов в минуту.

1. Узнайте цену. Вызовите GET /api/v1/prices?country=ar&service=<id>, чтобы код знал актуальную стоимость до списания средств с кошелька. Идентификатор страны для Аргентины — ar.
2. Закажите номер. Отправьте POST /api/v1/activations с JSON-телом {"service": "whatsapp", "country": "ar"}, подставив идентификатор сервиса, который нужен вашему тесту. В ответе будут идентификатор активации и номер +54, который нужно ввести в тестируемом приложении.
3. Дождитесь кода. Либо опрашивайте GET /api/v1/activations/{id} с разумным интервалом, либо дайте вебхуку activation.sms_received сообщить, что код пришёл.
4. При необходимости освободите номер раньше. POST /api/v1/activations/{id}/cancel завершает ненужную активацию и возвращает деньги на кошелёк.

Если хотите увидеть идентификаторы до того, как прописывать их в коде, GET /api/v1/services и GET /api/v1/countries перечисляют то, что платформа предлагает сейчас. Полный справочник — в документации.

Как сделать приёмник вебхуков надёжным для аргентинских кодов?

Каждая доставка содержит заголовок X-OTPRoute-Signature вида t=<unix>,v1=<hex>. Соберите строку "<t>.<raw body>", вычислите по ней HMAC-SHA256 секретом этого эндпоинта и сравните результат с v1 функцией, работающей за постоянное время. Отбрасывайте любой запрос с устаревшей меткой времени: старая, но действительная подпись выглядит ровно как повторная отправка (replay).

Помимо activation.sms_received, подпишитесь на activation.expired и activation.cancelled, чтобы тестовый раннер не зависал в ожидании номера, который уже закрыт. Считайте каждое событие привязанным к идентификатору активации и пишите обработчик так, чтобы повторная доставка того же события ничего не меняла. Статья о подписи и проверке вебхуков OTP подробнее разбирает логику сравнения.

С какими приложениями можно проверить аргентинский номер?

В актуальном срезе по Аргентине указано более 2 000 сервисов. Те, к которым чаще всего обращаются аргентинские продуктовые и QA-команды:

• Мессенджеры: WhatsApp, Telegram, Signal, Discord
• Аккаунты и продуктивность: Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI)
• Соцсети и видео: Instagram, TikTok
• Коммерция и транспорт: Amazon, Uber, Airbnb, Netflix

Этот список меняется в течение дня, поэтому API сообщает доступность в реальном времени, а не в статичной таблице. Перед запуском плановой CI-задачи обращайтесь к GET /api/v1/services с учётом страны ar и завершайте задачу сразу с понятным сообщением, если нужный сервис временно отсутствует.

Почему аргентинские мобильные номера сбивают с толку валидаторы телефонов?

План нумерации Аргентины — один из самых необычных в регионе. Внутри страны перед кодом города пишут внутренний префикс 0, а для мобильных перед абонентскими цифрами ставят 15, так что мобильный номер из Буэнос-Айреса может выглядеть как 011 15 и восемь цифр. В международной форме E.164 оба эти элемента исчезают, а сразу после кода страны вставляется 9: +54 9 11 и далее восьмизначный абонентский номер.

Это различие важно для всех, кто хранит телефонные номера. Приводите всё к E.164 до сохранения, убирайте 0 и 15 при вводе и добавляйте 9 для мобильных номеров. Валидатор, проверяющий только длину, охотно примет значение +54 11 в стиле стационарного номера, на которое SMS прийти не может. Используйте номер ровно в том виде, в каком его возвращает API, а не переформатируйте его сами.

Коды на аргентинские номера обычно приходят на испанском, часто с фразой вроде «Tu código es» рядом с цифрами. Извлекайте числовой код по шаблону, а не по формулировкам, потому что тексты меняются. Здесь тестируют при выходе на рынок Латинской Америки, при проверке рио-платского испанского (местные формы vos отличаются от учебного испанского), при региональных операциях или ради аргентинцев, живущих за границей, но регистрирующихся с SIM-картой +54.

Может ли сотрудник без навыков программирования заказать номер +54?

Да. Сотрудники поддержки, роста и агентств могут сделать всё из браузера:

1. Создайте аккаунт на странице регистрации по email и 6-значному коду или через вход Google.
2. Пополните кошелёк.
3. Откройте OTP Gateway, выберите Аргентину, затем сервис, который вы тестируете.
4. Проверьте показанную цену, подтвердите заказ и скопируйте номер +54 на экран верификации приложения.
5. Следите за активацией: код появится там, как только придёт.

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

Аргентинский код так и не пришёл. Что делать дальше?

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

Затем пройдитесь по короткому списку:

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

Наш материал о том, как снизить число неудачных доставок OTP, описывает и другие приёмы для аргентинских маршрутов. Проводите все тесты в рамках условий каждого сервиса; также действует политика допустимого использования OTP Route (Acceptable Use Policy).

Можно ли оставить аргентинскую линию за собой и как платить?

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

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

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

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

Это ar. Передавайте его в поле country запроса POST /api/v1/activations и в строке запроса GET /api/v1/prices.

Нужно ли добавлять 9, когда я ввожу номер +54 в приложении?

Используйте номер точно в том виде, в каком его возвращает OTP Route. В собственной базе храните аргентинские мобильные номера в формате E.164: он содержит 9 после +54 и не содержит внутренних 0 и 15.

Сколько стоит получение SMS с OTP из Аргентины?

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

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

Да. Закажите активацию для Аргентины под ваше приложение или сторонний сервис из теста, введите номер +54 и прочитайте код в панели или в вебхуке.

Подойдёт ли тот же номер +54 для входа в следующем месяце?

Нет. Номер шлюза принимает один код в течение 20 минут. Для аккаунтов, которым нужно получать коды постоянно, подходит выделенный номер в США или Канаде.

На каком языке придёт аргентинское проверочное сообщение?

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

Можно ли использовать опрос вместо вебхуков?

Да. Опрашивайте GET /api/v1/activations/{id} с умеренным интервалом и оставайтесь заметно ниже лимита 300 запросов в минуту на аккаунт.

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