Приём SMS-кодов Vinted на номера OTP Route через API

Какова последовательность вызовов API для активации Vinted?

API проверочных кодов Vinted использует те же эндпоинты OTP Gateway, что и любой другой сервис, по адресу https://otproute.com/api/v1 с Bearer-ключом с префиксом or_live_:

1. Подтвердите id сервиса через GET /api/v1/services; для Vinted это vinted. Id стран получите из GET /api/v1/countries.
2. Вызовите GET /api/v1/prices?country=<id>&service=vinted, чтобы увидеть актуальную цену и наличие номеров для этой пары.
3. Закажите номер через POST /api/v1/activations с телом вида {"service": "vinted", "country": "fr"}. Сохраните id активации и выданный номер.
4. Введите номер на шаге телефона в тестовом аккаунте Vinted и дождитесь кода.
5. Если сценарий прерван, POST /api/v1/activations/{id}/cancel сразу возвращает средства.

Ключи создаются в консоли разработчика, до 10 на аккаунт, а API принимает 300 запросов в минуту. GET /api/v1/balance — дешёвый предполётный вызов для CI-задачи. Справочные материалы собраны на странице для разработчиков.

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

Подпишите эндпоинт (на аккаунт разрешено пять) на activation.sms_received, а также на activation.expired и activation.cancelled, чтобы ожидающие задачи могли корректно завершаться. Каждая доставка содержит X-OTPRoute-Signature: t=<unix>,v1=<hex>.

• Вычислите HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта и сравните с v1 за постоянное время.
• Отбрасывайте запросы со старыми метками времени, чтобы блокировать повторное воспроизведение.
• Записывайте каждое событие по id активации, чтобы вторая доставка того же события ничего не меняла.
• Сначала отвечайте кодом 2xx, а медленную работу передавайте в очередь.

Для одиночного теста проще опрос: вызывайте GET /api/v1/activations/{id} раз в несколько секунд, пока не появится код или активация не завершится. Проверка подписи подробно показана в нашем руководстве по защите вебхуков OTP с помощью HMAC.

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

Vinted — маркетплейс подержанной одежды и других товаров, работающий как отдельные национальные сайты, преимущественно в Европе. Как и многие маркетплейсы, он может просить участников добавить и подтвердить номер телефона Vinted — например, при создании аккаунта, при входе с незнакомого устройства или перед изменением важных данных аккаунта. Точные запросы различаются по рынкам и со временем меняются, поэтому любой тестовый план стоит перепроверять после обновлений приложения Vinted.

Для команд, работающих вокруг Vinted, — инструменты для продавцов, агентства, ведущие собственный магазин бренда, QA-инженеры, проверяющие интеграцию, — SMS-верификация Vinted в тестах означает просто доставку одного кода на номер, который вы контролируете.

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

Номера Vinted доступны в 198 странах. Среди европейских вариантов — Франция, Германия, Великобритания, Испания, Италия, Польша, Литва, Нидерланды, Бельгия, Чехия, Португалия, Австрия, Швеция, Ирландия и Румыния, а полный список в GET /api/v1/countries выходит далеко за пределы Европы.

На маркетплейсе страна номера значит больше, чем в мессенджере. Берите номер из того же рынка, что и тестируемый аккаунт: профиль Vinted принадлежит одному национальному сайту, и номер из другой страны могут отклонить или он просто будет выглядеть для пользователя неправильно. Как сопоставлять тестовые сценарии с маршрутами, объясняет наш материал о маршрутизации OTP по странам.

Можно ли получить OTP Vinted из панели?

Да. Войдите, пополните кошелёк, откройте OTP Gateway и выберите Vinted и страну аккаунта. Цена показывается до подтверждения. Скопируйте номер в Vinted, и код появится на странице активации, как только придёт. Это тот же заказ, который создал бы вызов API, поэтому результаты ручных и автоматических проверок сопоставимы.

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

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

Частые причины отсутствия кода:

• Виртуальные номера отклоняются. Vinted, как и многие платформы, может отказать виртуальному номеру при подтверждении телефона. Никакой маршрут этого не меняет — поэтому и существует возврат.
• Медленная доставка. Время зависит от маршрута, так что дайте окну отработать, прежде чем сдаваться.
• Скудное наличие. Повторите чуть позже или с другой страной, которая всё ещё подходит вашему тесту.
• Лавина повторов. Повторный заказ в тугом цикле редко помогает; делайте паузы и записывайте id каждой активации.

Бывает ли долгосрочный номер лучшим выбором для работы с Vinted?

Одноразовый номер принимает один код. Если тестовому аккаунту нужно позже войти снова или операционной команде нужно получать уведомления аккаунта на стабильную линию, лучше подходит выделенный номер, но он продаётся только для США и Канады, от $1.95/month, с входящими SMS в панели и на вебхуке number.sms_received. Поскольку большинство рынков Vinted — европейские, это помогает только когда американский или канадский номер действительно подходит аккаунту. Компромиссы разобраны в сравнении временных и выделенных номеров.

Как использовать номера Vinted ответственно?

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

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

Какой id сервиса OTP Route использует для Vinted?

Используйте vinted в GET /api/v1/prices и в теле POST /api/v1/activations.

Сколько стоит получение OTP Vinted?

От $0.20 за код; точная цена зависит от страны, возвращается API в реальном времени и показывается в панели.

Спишут ли деньги, если Vinted отклонит номер?

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

Из какой страны должен быть мой тестовый номер для Vinted?

Подбирайте номер под национальный сайт тестируемого аккаунта, чтобы он соответствовал рынку, которому принадлежит профиль.

Можно ли протестировать интеграцию с Vinted, не тратя средства кошелька?

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

Можно ли оплачивать номера для верификации Vinted криптовалютой?

Предоплаченный кошелёк в USD принимает карты и стейблкоины USDT/USDC; на каждое пополнение по почте приходит PDF-счёт, ежемесячной платы нет.

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