Проверка по SMS Mercado Libre в тестовых и операционных процессах

Ситуация: разработка на маркетплейсе из многих региональных сайтов

Mercado Libre управляет отдельными региональными сайтами по всей Латинской Америке, а интеграцию для продавцов, панель логистики или инструмент мониторинга цен часто приходится тестировать сразу на нескольких из них. Каждый тестовый аккаунт привязан к стране, и каждый рано или поздно запрашивает номер телефона. Команды, которые полагаются на телефоны сотрудников, в итоге привязывают личные номера к бизнес-аккаунтам, а тестовые прогоны ждут того, кто сейчас на связи.

Виртуальный номер для Mercado Libre от OTP Route даёт QA и операционным командам более чистый путь: номер в нужном рынке, код, полученный по API, и никаких личных SIM-карт. Командам маркетплейсов стоит заглянуть на страницу решений для маркетплейсов.

Когда Mercado Libre запрашивает номер телефона?

Как и большинство крупных маркетплейсов, Mercado Libre использует подтверждение по телефону в нескольких предсказуемых точках: при создании аккаунта, при входе с незнакомого устройства, при восстановлении доступа и при изменении данных безопасности. В SMS приходит короткий цифровой код, обычно на испанском, а на бразильском сайте Mercado Livre — на португальском. Тест должен извлекать цифры, а не сопоставлять текст сообщения: формулировки могут измениться в любой момент.

В каких странах можно получить номер для Mercado Libre?

Сервис mercado сейчас доступен на маршрутах в 201 стране. Чаще всего команды выбирают те, что соответствуют присутствию самого маркетплейса: Аргентина, Бразилия, Мексика, Колумбия, Чили, Уругвай, Перу, Эквадор, Боливия, Парагвай, Венесуэла, Коста-Рика, Панама, Гватемала, Сальвадор, Гондурас, Доминиканская Республика и США.

Выбор страны — не формальность. Аккаунт, зарегистрированный на одном региональном сайте, как правило, ожидает номер именно этого рынка, поэтому выбирайте маршрут под тестовый случай. Доступность меняется в течение дня; перед каждым прогоном проверяйте GET /api/v1/countries.

Как работает API кода подтверждения Mercado Libre?

Используйте Bearer-ключ из консоли разработчика (префикс or_live_) и адрес https://otproute.com/api/v1:

1. Проверьте цену, например GET /api/v1/prices?country=ar&service=mercado.
2. Создайте активацию через POST /api/v1/activations с телом {"service": "mercado", "country": "ar"}.
3. Введите полученный номер на экране подтверждения Mercado Libre.
4. Получите событие activation.sms_received или опрашивайте GET /api/v1/activations/{id}.

Для вебхуков проверяйте X-OTPRoute-Signature (HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта), отбрасывайте старые метки времени и делайте обработчик идемпотентным: опирайтесь на идентификатор активации, чтобы повторная доставка не отправила один и тот же код дважды. Опрос подходит для коротких скриптов, вебхуки — для CI. Планируйте тестовую матрицу маркетплейса с учётом лимитов аккаунта: 10 ключей, 5 вебхук-эндпоинтов, 300 запросов в минуту. См. документацию и приём OTP через вебхуки.

Интеграции нет? В панели выберите Mercado Libre и страну, закажите номер, вставьте его и дождитесь кода на экране.

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

Маркетплейсы тщательно защищают регистрацию и вход, и Mercado Libre может отклонять некоторые виртуальные номера. Доставка зависит также от маршрута и момента времени. У каждой активации есть 20-минутное окно: если SMS не пришло или вы отменили заказ, вся сумма автоматически возвращается на кошелёк.

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

Подробнее — в материале о снижении числа недоставленных OTP.

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

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

Ответственное использование и оплата

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

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

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

Можно ли получить OTP Mercado Libre через API?

Да. Создайте активацию с сервисом mercado и идентификатором страны, затем прочитайте код через опрос или вебхук activation.sms_received.

Какую страну выбрать для тестового аккаунта Mercado Libre?

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

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

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

Сколько стоит проверка по SMS Mercado Libre для тестирования?

От $0.20 за код; точная цена зависит от страны и показывается через GET /api/v1/prices до заказа.

Можно ли сохранить тот же номер для будущих входов в Mercado Libre?

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

Как не дать вебхуку обработать один и тот же код дважды?

Сохраните идентификатор активации при первом событии и после проверки подписи игнорируйте повторы для этого идентификатора.

Можно ли открыть несколько аккаунтов Mercado Libre на номера OTP Route?

Только если каждый аккаунт принадлежит реальному человеку или компании и условия Mercado Libre это допускают. Дублирующие и промо-аккаунты не разрешены.

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