Подключите покупку в кредит к своему сайту

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

Ноутбук и банковская карта

Как это работает

1

Товар в корзине

Клиент добавляет товар и выбирает оплату «в кредит / рассрочку» на вашей витрине

2

Условия кредита

Клиент выбирает срок и первоначальный взнос — в виджете Ванты или в вашем калькуляторе

3

Идентификация через Госуслуги

Клиент присоединяется к платформе Ванта и подтверждает личность

4

Анкета и скоринг

Данные проверяются и уходят на рассмотрение сразу во все банки-партнёры

5

Выбор предложения

Клиент сравнивает предложения банков

6

СМС-подпись

Клиент подписывает договор кодом из СМС — весь процесс занимает около 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ОбязательностьнетОписаниеВнешний идентификатор торговой точки в вашей системе

Для интерфейсов

Все об использовании фирменного стиля на вашем сайте

Подробнее
Figma

Формирование ссылки

Метод возвращает ссылку на страницу виджета — на неё нужно перенаправить клиента.

Метод
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"
}'

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

Поддержка

Вопросы по интеграции, доступам и статусу подключения — к вашему персональному куратору

Оставить заявку на подключение