Как получить SMS-код Mercado Pago в тестовом прогоне

Какую задачу решают команды на шаге с телефоном в Mercado Pago?

Mercado Pago, платёжная платформа и цифровой кошелёк от Mercado Libre, — часть повседневной торговли по всей Латинской Америке. Как и большинство финансовых приложений, он привязывает аккаунт к номеру телефона: SMS-код подтверждает номер при регистрации, а при входе с нового устройства или восстановлении доступа приложение может запросить новый код. Для команд, которые строят продукты вокруг него (мерчанты, настраивающие оплату, агентства, управляющие клиентским аккаунтом продавца, или QA-инженеры, тестирующие маркетплейс с оплатой через Mercado Pago), этот SMS-шаг часто оказывается самым неудобным. Сотрудники вешают личные номера на бизнес-аккаунты, а тест-кейс встаёт, потому что единственный человек с нужной SIM-картой не на связи.

OTP Route превращает этот шаг в то, с чем справляются ваши инструменты: номер по запросу для нужного рынка и код, доставленный в ваши системы. Это и есть суть проверки по SMS Mercado Pago для тестирования.

Как устроен сценарий API кода подтверждения Mercado Pago?

Все запросы отправляются на https://otproute.com/api/v1 с Bearer-ключом (префикс or_live_) из консоли разработчика. Идентификатор сервиса — mercado_pago; идентификатор страны — значение api_country для вашего рынка, например br для Бразилии или mx для Мексики.

1. GET /api/v1/prices?country=br&service=mercado_pago возвращает актуальную цену и доступность для этой пары.
2. POST /api/v1/activations с телом {"service": "mercado_pago", "country": "br"} возвращает идентификатор активации и номер.
3. Введите номер на шаге с телефоном в аккаунте, который вы настраиваете или тестируете.
4. Заберите код, когда activation.sms_received придёт на ваш эндпоинт, либо опросом GET /api/v1/activations/{id}.
5. Если прогон завершился раньше, вызовите POST /api/v1/activations/{id}/cancel.

Используйте GET /api/v1/balance как проверку перед запуском. Каждому аккаунту доступны 10 ключей, 5 вебхук-эндпоинтов и 300 запросов в минуту; всё остальное — в документации.

Как обработчик вебхука должен работать с кодами Mercado Pago?

Доставка по push избавляет тестовые раннеры от циклов опроса. Каждое событие приходит с X-OTPRoute-Signature: t=<unix>,v1=<hex>; вычислите HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта, сравните за постоянное время и отбрасывайте запросы со старой меткой времени. Затем сделайте обработчик идемпотентным: сохраняйте идентификатор активации и игнорируйте повторную доставку того же события, ведь повторные отправки случаются. Слушайте также activation.expired и activation.cancelled, чтобы раннер мог освободить слот и пометить тест для новой попытки. Если вы не хотите поднимать эндпоинт, опрос активации каждые несколько секунд спокойно укладывается в лимит запросов. Более полный чек-лист — в материале о защите вебхуков OTP.

Из какой страны брать номер для Mercado Pago?

Сервис mercado_pago представлен в 201 стране на OTP Route, но полезный выбор почти всегда — рынок, которому принадлежит аккаунт. Mercado Pago лучше всего известен в Бразилии, Аргентине, Мексике, Чили, Колумбии, Уругвае и Перу, поэтому там и живёт большинство тест-кейсов. Каталог охватывает также Эквадор, Боливию, Парагвай, Коста-Рику, Панаму, Доминиканскую Республику, Испанию, Португалию и США, помимо многих других.

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

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

Не разработчики получают тот же результат без кода. Откройте OTP Gateway, выберите Mercado Pago как сервис, выберите страну и проверьте цену, показанную перед заказом. Скопируйте номер в приложение, запросите SMS, и код появится на карточке активации, как только будет доставлен. Номер удерживается 20 минут; если ничего не пришло, ничего не списывается, потому что сумма автоматически возвращается на кошелёк.

Почему код Mercado Pago может не прийти?

Платёжные платформы осторожно относятся к телефонным номерам, и виртуальный номер для Mercado Pago может быть отклонён в некоторых или во всех сценариях. Кроме того, маршруты меняются в течение дня. Если кода нет:

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

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

Когда выделенный номер подходит лучше?

Одноразовый номер принимает один код. Бизнес-аккаунту, который запросит новый код через несколько месяцев, нужен номер, остающийся под вашим контролем. Выделенные номера OTP Route (Dedicated Numbers) выполняют эту роль в США и Канаде, от $1.95/мес.: входящие SMS в панели и на вашем вебхуке (number.sms_received), исходящие SMS и звонки из браузера, продление с кошелька, пока вы не освободите линию. За пределами этих двух стран самостоятельно оформляемой долгосрочной линии нет; напишите на [email protected], чтобы уточнить, при этом доступность зависит от местных правил. Подробности — на странице виртуальных номеров.

Какие правила действуют при использовании этих номеров с Mercado Pago?

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

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

Можно ли получить OTP Mercado Pago без местной SIM-карты в Бразилии или Мексике?

Да, если вы тестируете или обслуживаете собственный аккаунт. Закажите номер mercado_pago для нужной страны и прочитайте код в панели, через API или вебхук.

Какой идентификатор сервиса Mercado Pago в API?

Это mercado_pago. Укажите его вместе с идентификатором страны в теле POST /api/v1/activations.

Принимает ли Mercado Pago виртуальные номера?

Не всегда. В некоторых сценариях он может их отклонять, поэтому, если код не пришёл за 20 минут, вся сумма возвращается.

Сколько стоит телефонный номер для проверки Mercado Pago?

От $0.20 за код. Точная цена зависит от страны и показывается в API и панели до заказа.

Можно ли использовать один и тот же одноразовый номер, чтобы войти снова в следующем месяце?

Нет. Одноразовый номер принимает единственный код. Аккаунтам, которым нужны повторные входы, лучше подходит выделенный номер (Dedicated Number) в США или Канаде.

Может ли мой CI-конвейер прогонять сценарий Mercado Pago без реальных списаний?

Да. Запросите режим песочницы для аккаунта разработки: он возвращает имитированные номера и коды через те же эндпоинты.

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