Подключите покупку в кредит к своему сайту
Ванта — маркетплейс для оформления кредитов и рассрочек. Платформа подбирает предложения банков и оформляет договор. Ниже — два способа подключения и справочник API

Как это работает
Товар в корзине
Клиент добавляет товар и выбирает оплату «в кредит / рассрочку» на вашей витрине
Условия кредита
Клиент выбирает срок и первоначальный взнос — в виджете Ванты или в вашем калькуляторе
Идентификация через Госуслуги
Клиент присоединяется к платформе Ванта и подтверждает личность
Анкета и скоринг
Данные проверяются и уходят на рассмотрение сразу во все банки-партнёры
Выбор предложения
Клиент сравнивает предложения банков
СМС-подпись
Клиент подписывает договор кодом из СМС — весь процесс занимает около 2,5 минут
Два способа интеграции
Процесс одинаковый для обоих способов — разница только в том, где отображаются экраны
Redirect-виджет
- Время на интеграцию
- От одного дня
- Контроль над UX
- Экраны Ванты
- Что нужно реализовать
- Формирование ссылки и редирект
- Кому подходит
- Большинству партнёров, маркетплейсам, ecom-витринам
Marketplace API
- Время на интеграцию
- От нескольких недель
- Контроль над UX
- Полностью ваш интерфейс
- Что нужно реализовать
- Анкета, калькулятор, статусы, идентификация, подпись
- Кому подходит
- Партнёрам с собственным «финансовым» UX и высоким трафиком
Redirect-виджет
Вы передаёте данные о товаре и параметры кредита — получаете ссылку и отправляете её клиенту. Дальше Ванта берёт всё на себя: идентификация, анкета, скоринг и подписание договора
1
Клиент нажимает «Купить в кредит», вы отправляете POST-запрос и получаете ссылку на виджет
2
Идентификация, анкета, банковские предложения, СМС-подпись договора
3
Клиент возвращается по successUrl или errorUrl — кредит уже оформлен
Виджет можно открыть как полноэкранный редирект, так и в модальном окне/webview вашего приложения — на вашей стороне остаётся только переход по полученной ссылке.
Доступ и идентификаторы
Перед интеграцией менеджер Ванты выдаёт вам partner-id — он передаётся в каждом запросе и связывает заявки с вашим юрлицом.
| Заголовок | Тип | Обязательность | Описание |
|---|---|---|---|
Заголовокx-partner-id | Типstring | Обязательностьда | ОписаниеID партнёра — выдаётся менеджером Ванты |
Заголовокx-trade-id | Типstring | Обязательностьнет | ОписаниеИдентификатор торговой точки в системе Ванта |
Заголовокx-external-trade-id | Типstring | Обязательностьнет | ОписаниеВнешний идентификатор торговой точки в вашей системе |
Для интерфейсов
Все об использовании фирменного стиля на вашем сайте
Формирование ссылки
Метод возвращает ссылку на страницу виджета — на неё нужно перенаправить клиента.
- Метод
- POST
- URL
- /v1/widget/online
- Хост
- api-request.vanta.ru
- Формат
- application/json
Схема · тело запроса
{
"goods": [{
"price": number,
"count": number,
"brand": string,
"model": string,
"name"?: string
}],
"calculatorParams": {
"terms": number[],
"creditType": 1 | 2,
"hideCalculator"?: boolean,
"fromTo"?: [number, number]
},
"redirectUrl"?: {
"defaultUrl": string,
"successUrl"?: string,
"errorUrl"?: string
},
"orderId"?: string
}goods — товары в заказе
Обязательный массив товаров.
| Поле | Тип | Обязательно | Описание | Валидация |
|---|---|---|---|---|
Полеprice | Типnumber | Обязательнода | ОписаниеСтоимость единицы товара | Валидациябольше 0 |
Полеcount | Типnumber | Обязательнода | ОписаниеКоличество товаров | Валидациябольше 0 |
Полеbrand | Типstring | Обязательнода | ОписаниеБренд товара | Валидация— |
Полеmodel | Типstring | Обязательнода | ОписаниеМодель товара | Валидация— |
Полеname | Типstring | Обязательнонет | ОписаниеКатегория товара из справочника b2pos | Валидациястрого по справочнику |
calculatorParams — параметры кредита
Обязательный объект конфигурации калькулятора.
| Поле | Тип | Обязательно | Описание | Валидация |
|---|---|---|---|---|
Полеterms | Типnumber[] | Обязательнода | ОписаниеСроки кредита для отображения в калькуляторе или для расчёта на этапе создания ссылки | Валидациястрого по возрастанию; длина 1–6 без fromTo, иначе 1–5 |
ПолеcreditType | Тип1 | 2 | Обязательнода | ОписаниеТип кредита: 1 — кредит, 2 — рассрочка | Валидациястрого 1 или 2 |
ПолеhideCalculator | Типboolean | Обязательнонет | ОписаниеРассчитать калькулятор ещё на этапе создания ссылки и скрыть в виджете первый шаг (шаг с калькулятором) | Валидация— |
ПолеfromTo | Тип[number, number] | Обязательнонет | ОписаниеДиапазон срока кредитования | Валидациядлина массива строго 2, по возрастанию |
redirectUrl — возврат на ваш сайт
Необязательный объект — если не передать, клиент останется на странице Ванты по завершении.
| Поле | Тип | Обязательно | Описание | Валидация |
|---|---|---|---|---|
ПолеdefaultUrl | Типstring | Обязательнода | ОписаниеСсылка для возврата по умолчанию, если у партнёра нет отдельных страниц для исходов | Валидациявид http(s)://domen.zone |
ПолеsuccessUrl | Типstring | Обязательнонет | ОписаниеСсылка на страницу партнёра при успешной выдаче кредита | Валидациявид http(s)://domen.zone |
ПолеerrorUrl | Типstring | Обязательнонет | ОписаниеСсылка на страницу партнёра при неуспешной выдаче или другой критической ошибке внутри виджета | Валидациявид http(s)://domen.zone |
Пример запроса
В ответ вы получаете ссылку на страницу виджета — перенаправьте на неё клиента (редирект или открытие в webview/модальном окне).
cURL · POST /v1/widget/online
curl --location 'https://api-request.vanta.ru/v1/widget/online' \
--header 'x-partner-id: xxxxxxxxx-xxxx-xxxxxxx-xxxx-xxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"calculatorParams": {
"fromTo": [6, 32],
"terms": [8, 12, 16, 24],
"creditType": 2,
"hideCalculator": false
},
"goods": [{
"name": "КИПЯТИЛЬНИК",
"price": 100000,
"count": 1,
"brand": "KIA",
"model": "RIO"
}],
"redirectUrl": {
"defaultUrl": "https://vanta.ru",
"successUrl": "https://vanta.ru",
"errorUrl": "https://vanta.ru"
},
"orderId": "sadkfjlasdfjasdlfkj"
}'Частые вопросы
Поддержка
Вопросы по интеграции, доступам и статусу подключения — к вашему персональному куратору
Marketplace API
Полный REST-like API процесса выдачи товарного кредита: анкета клиента, скоринг во все банки-партнёры, предложения, выбор и авторизация КД — на ваших собственных экранах. Черновик текущей версии — v0.16
Перед интеграцией сверяйте детали с вашим менеджером Ванты
Когда выбирать API вместо виджета
Вы хотите вести клиента по своему собственному дизайну, без перехода на страницу Ванты
У вас высокий трафик и заметна потеря конверсии на внешнем редиректе
Нужно встроить шаги оформления кредита в уже существующий чекаут или мобильное приложение
Идентификация личности в любом случае происходит через отдельный модуль Ванты (открывается по ссылке в webview) — это единственный экран, который не строится на вашей стороне.
Аутентификация
Идентификатор и токен приложения партнёр получает в процессе интеграции с Vanta marketplace. Они передаются в заголовках каждого запроса:
| Заголовок | Описание |
|---|---|
ЗаголовокX-App-ID | ОписаниеUUID приложения |
ЗаголовокX-App-Token | ОписаниеТокен приложения |
Структура запросов и ответов
За основу стиля спецификации взят JSON API. Технически — REST-like API по HTTPS, тело запросов и ответов в JSON
Для GET-запросов тело (body) передавать не нужно
Поля со значением null не передаются и не возвращаются
Лишние переданные атрибуты игнорируются сервером
Пример · тело запроса
{
"data": {
"Тело": "запроса"
},
"meta": {
"requestKey": "e3a3c589-e402-4b1d-9121-6e448ad9816d",
"blankVersion": 1000121
}
}Пример · ошибка
{
"title": "Произошла ошибка",
"status": "403",
"detail": "Forbidden",
"message": "Доступ к данному процессу запрещён"
}Версии и идемпотентность
В разделе meta для не идемпотентных методов POST/PATCH должны передаваться:
| Поле | Описание |
|---|---|
ПолеrequestKey | ОписаниеКлюч идемпотентности. Генерируется на стороне клиента, формат uuid v6. Клиент гарантирует уникальность ключа в рамках одного бланка |
ПолеblankVersion | ОписаниеВерсия объекта /blank, для которой выполняется действие. Актуальная версия всегда возвращается в meta ответа |
Если вызвать изменяющий метод с версией, отличной от актуальной, сервер вернёт ошибку с просьбой перечитать бланк и повторить запрос с актуальной blankVersion
Справочник ресурсов
Карта ресурсов API (в рамках блока data):
| Первый уровень | Второй уровень | Описание |
|---|---|---|
| Первый уровень/blank/{id} | Второй уровень— | ОписаниеАнкета |
| Первый уровень | Второй уровень/calculator | ОписаниеКалькулятор |
| Первый уровень | Второй уровень/command | ОписаниеКоманды |
| Первый уровень | Второй уровень/status | ОписаниеСтатус |
| Первый уровень | Второй уровень/application | ОписаниеПредложения |
| Первый уровень | Второй уровень/documents | ОписаниеДокументы |
| Первый уровень/callback | Второй уровень | ОписаниеПодписка на события |
| Первый уровень/upload | Второй уровень— | ОписаниеЗагрузка документов |
Сценарии интеграции
Пять сквозных сценариев, которые нужно реализовать на своей стороне: от идентификации клиента до подписания и возможной отмены заявки
Идентификация — новый клиент
Старт процесса
Приложение отправляет команду startIdentification через POST /blank/{id}/command.
Ссылка на модуль
Система добавляет ссылку на модуль идентификации в GET /blank/{id}/status → identification.identificationLink.
Открытие в webview
Приложение вычитывает ссылку и открывает модуль идентификации во встроенном webview.
Прохождение идентификации
Пользователь подтверждает личность через Госуслуги внутри модуля.
Поллинг статуса
Приложение опрашивает GET /blank/{id}/status, ожидая identification.status = IDENTIFIED.
Закрытие webview и данные клиента
При статусе IDENTIFIED приложение закрывает webview и вычитывает данные клиента из /status.
Обязательные поля для запуска скоринга
Прежде чем вызывать команду startScoring, анкета должна содержать все поля из списка ниже. Часть из них Ванта заполняет сама из данных Госуслуг после идентификации (“Автоматически“), часть должны прийти от вас или от клиента (“Обязательно“)
| Название поля | Поле | Тип заполнения |
|---|---|---|
| Название поляUUID бланка | Полеuuid | Тип заполненияАвтоматически |
| Блок данных клиента — client | ||
| Название поляДата рождения | Полеclient.birthDate | Тип заполненияАвтоматически |
| Название поляПол | Полеclient.gender | Тип заполненияАвтоматически |
| Название поляМесто рождения | Полеclient.birthPlace | Тип заполненияАвтоматически |
| Персональные данные — client.personalData | ||
| Название поляФамилия | Полеclient.personalData.lastName | Тип заполненияАвтоматически |
| Название поляИмя | Полеclient.personalData.firstName | Тип заполненияАвтоматически |
| Название поляМобильный телефон | Полеclient.personalData.mobilePhone | Тип заполненияАвтоматически |
| Название поляЭлектронная почта | Полеclient.personalData.email | Тип заполненияОбязательно |
| Название поляСНИЛС | Полеclient.personalData.snils | Тип заполненияАвтоматически |
| Название поляФлаг — пенсионер | Полеclient.personalData.retired | Тип заполненияОбязательно |
| Паспорт — client.passport | ||
| Название поляСерия | Полеclient.passport.serial | Тип заполненияАвтоматически |
| Название поляНомер | Полеclient.passport.number | Тип заполненияАвтоматически |
| Название поляКод подразделения | Полеclient.passport.divisionCode | Тип заполненияАвтоматически |
| Название поляВыдан кем | Полеclient.passport.issuer | Тип заполненияАвтоматически |
| Название поляДата выдачи | Полеclient.passport.registerDate | Тип заполненияАвтоматически |
| Дополнительные данные — client.additionalData | ||
| Название поляЕжемесячный основной доход | Полеclient.additionalData.monthlyMainIncome | Тип заполненияОбязательно |
| Контактное лицо — client.firstContactPerson | ||
| Название поляТелефон контактного лица | Полеclient.firstContactPerson.mobilePhone | Тип заполненияОбязательно |
| Адреса — client.addresses | ||
| Название поляДата постановки на регистрацию | Полеclient.addresses.registrationDate | Тип заполненияОбязательно |
| Название поляФлаг — адрес регистрации совпадает с фактическим | Полеclient.addresses.addressesMatch | Тип заполненияОбязательно |
| Адрес регистрации — client.registration | ||
| Название поляБлок адреса ДаДаты (город, регион, нас. пункт, дом) | Полеclient.registration.daData | Тип заполненияОбязательно |
| Название поляОбъект ДаДаты | Полеclient.registration.daData.daDataObject | Тип заполненияОбязательно |
| Фактический адрес — client.residential | ||
| Название поляБлок адреса ДаДаты (город, регион, нас. пункт, дом) | Полеclient.residential.daData | Тип заполненияОбязательно, если не совпадает |
| Название поляОбъект ДаДаты | Полеclient.residential.daData.daDataObject | Тип заполненияОбязательно, если не совпадает |
| Работа — client.work | ||
| Название поляИНН работодателя | Полеclient.work.inn | Тип заполненияОбязательно, если не пенсионер |
| Название поляНазвание компании | Полеclient.work.name | Тип заполненияАвтоматически по ИНН |
| Название поляТелефон работодателя | Полеclient.work.phone | Тип заполненияОбязательно, если не пенсионер |
| Название поляАдрес работодателя | Полеclient.work.address | Тип заполненияАвтоматически по ИНН |
| Название поляБлок данных ДаДаты | Полеclient.work.daData | Тип заполненияАвтоматически по ИНН |
| Калькулятор — calculator | ||
| Название поляТип кредита | Полеcalculator.type | Тип заполненияОбязательно |
| Название поляСрок кредита | Полеcalculator.period | Тип заполненияОбязательно |
| Название поляПервоначальный платёж | Полеcalculator.firstPayment | Тип заполненияОбязательно |
| Название поляВыбранные банковские продукты | Полеcalculator.selectedProductsIds | Тип заполненияОбязательно |
| Название поляВыбранные доп. продукты | Полеcalculator.selectedInsurancesIds | Тип заполненияОбязательно |
| Корзина — goods | ||
| Название поляКатегория | Полеgoods.category | Тип заполненияОбязательно |
| Название поляМодель + артикул | Полеgoods.model | Тип заполненияОбязательно |
| Название поляБренд | Полеgoods.brand | Тип заполненияОбязательно |
| Название поляСтоимость в копейках | Полеgoods.price | Тип заполненияОбязательно |
Справочник статусов
Все значения статусов, которые встречаются в объекте GET /blank/{id}/status, сгруппированные по процессу.
Анкета — blank.status
| Статус | Значение |
|---|---|
СтатусDRAFT | ЗначениеЧерновик |
СтатусPROCESSING | ЗначениеВ обработке |
СтатусAPPROVED | ЗначениеОдобрено |
СтатусREJECTED | ЗначениеОтказано |
СтатусCANCELED | ЗначениеОтменено |
СтатусAWAITING | ЗначениеОжидание |
СтатусCOOLING | ЗначениеПериод охлаждения |
СтатусAUTHORIZED | ЗначениеАвторизовано |
СтатусERROR | ЗначениеОшибка |
Идентификация — identification.status
| Статус | Значение |
|---|---|
СтатусNONE | ЗначениеПроцесс идентификации не начат |
СтатусIN_PROGRESS | ЗначениеНачат процесс идентификации |
СтатусAWAITING_CONFIRM_CODE | ЗначениеОжидание кода подтверждения (повторный клиент) |
СтатусIDENTIFIED | ЗначениеИдентифицирован |
СтатусERROR | ЗначениеОшибка |
Подтверждение СМС — identification.confirmStatus / auth.confirmStatus
Одинаковая таблица значений используется и для идентификации повторного клиента, и для подписания договора.
| Статус | Значение |
|---|---|
СтатусNONE | ЗначениеПроцесс не начинался |
СтатусSENT | ЗначениеСМС отправлена |
СтатусSMS_MATCHED | ЗначениеКод совпал |
СтатусSMS_NOT_MATCHED | ЗначениеКод не совпал |
СтатусSMS_TIMEOUT | ЗначениеИстёк срок действия кода |
СтатусERROR | ЗначениеОшибка |
smsTryLeft и smsSendLeft — счётчики оставшихся попыток, по 3 на каждое действие.
Скоринг — scoring.status
| Статус | Значение |
|---|---|
СтатусNONE | ЗначениеПроцесс скоринга не начат |
СтатусIN_PROGRESS | ЗначениеИдёт процесс скоринга |
СтатусFINISHED | ЗначениеСкоринг завершён |
СтатусERROR | ЗначениеОшибка скоринга |
Заявки и предложения — application.status
| Статус | Значение |
|---|---|
СтатусNEW | ЗначениеНовая заявка |
СтатусWAITING | ЗначениеЖдём решения |
СтатусREJECTED | ЗначениеОтказано |
СтатусAPPROVED | ЗначениеОдобрено |
СтатусCANCELED | ЗначениеЗаявка отменена |
СтатусACCEPTED | ЗначениеЗаявка подтверждена |
СтатусWAITING_FOR_AUTH | ЗначениеОжидает авторизации |
СтатусCOOLING | ЗначениеПериод охлаждения |
СтатусAUTHORIZED | ЗначениеДоговор авторизован |
СтатусAUTH_CANCELED | ЗначениеАвторизация отменена |
СтатусERROR | ЗначениеОшибка |
СтатусDISABLED | ЗначениеОтключён |
СтатусCLIENT_REJECTED | ЗначениеОтказ клиента |
Выбор предложения — application.accept.status
| Статус | Значение |
|---|---|
СтатусNONE | ЗначениеПроцесс не начинался |
СтатусREQUESTED | ЗначениеПредложение принято, запрошен КД |
СтатусACCEPTED | ЗначениеПредложение принято, КД получен |
СтатусCANCELED | ЗначениеПредложение отменено |
СтатусERROR | ЗначениеОшибка |
Авторизация — auth.status
| Статус | Значение |
|---|---|
СтатусNONE | ЗначениеПроцесс не начинался |
СтатусAWAITING_CONFIRM_CODE | ЗначениеОжидание кода подтверждения |
СтатусIN_PROGRESS | ЗначениеВ процессе авторизации |
СтатусREJECTED | ЗначениеОтклонено |
СтатусCOOLING | ЗначениеПериод охлаждения |
СтатусAUTHORIZED | ЗначениеАвторизовано |
СтатусCANCELED | ЗначениеАвторизация отменена |
СтатусERROR | ЗначениеОшибка |
Документы — documentSuite.status
| Статус | Значение |
|---|---|
СтатусNONE | ЗначениеНе проверялось |
СтатусNOTCHECKED | ЗначениеЕщё не проверено |
СтатусCHECKED | ЗначениеПроверено |
СтатусERROR | ЗначениеОшибка |
Вебхуки
Асинхронная альтернатива поллингу GET /blank/{id}/status: оформите подписку на нужные процессы — и Ванта сама пришлёт уведомление на ваш адрес, как только там что‑то изменится
Callback — это только триггер, а не полный слепок состояния. Получив уведомление, обязательно запросите актуальные данные через GET /api/{version}/blank/{blankId}/status — сам callback лишь сообщает, что и где изменилось.
Как это устроено
Оформление подписки
Партнёр вызывает POST /api/{version}/blank/{blankId}/callback, указывая callbackUrl, HTTP-метод отправки и состав отслеживаемых процессов subscription
Событие в анкете
Как только в одном из отслеживаемых процессов меняется статус, Marketplace отправляет callback на callbackUrl с указанием источника изменения — поле source
Уточнение состояния
Партнёр вызывает GET /api/{version}/blank/{blankId}/status, чтобы получить актуальное состояние процесса, вызвавшего событие
Что можно отслеживать
| Значение subscription | Процесс |
|---|---|
Значение subscriptionidentification | ПроцессИдентификация |
Значение subscriptionscoring | ПроцессСкоринг |
Значение subscriptionapplication | ПроцессПолучение предложений банков |
Значение subscriptionaccept | ПроцессВыбор предложения |
Значение subscriptionauthorization | ПроцессАвторизация |
Можно подписаться на один процесс или сразу на несколько — состав передаётся списком в subscription при создании или изменении подписки (методы POST/PATCH, подробности в справочнике ресурсов).
Типы событий
| Событие | Тип |
|---|---|
| СобытиеИзменился статус процесса | ТипstatusUpdatedNotification |
Схема события
На ваш · callbackUrl
{
"type": "statusUpdatedNotification",
"blankId": "uuid", // ID анкеты
"orderId": "uuid", // ID заказа в вашей системе
"source": "identification" // какой процесс изменился
}Управление подпиской
POST
создать подписку (callbackUrl, method, subscription)
GET
получить текущие параметры подписки
PATCH
заменить состав subscription (адрес callbackUrl так не меняется)
DELETE
удалить подписку и остановить отправку событий
Полные схемы запросов и ответов по каждому методу — в карточке /api/{version}/blank/{blankId}/callback справочника ресурсов.
Подписка живёт 3 месяца — на длинных сценариях её нужно продлевать (пересоздавать) самостоятельно.
Частые вопросы
Поддержка
Вопросы по интеграции, доступам и статусу подключения — к вашему персональному куратору