Виджеты оплаты Яндекс Пэй

Виджет Яндекс Пэй позволяет встроить на ваш сайт кнопку оплаты вместе с сопроводительными продуктами, которые в совокупности увеличивают конверсию: оплата в рассрочку, информация о кэшбэке.

Для виджета оплаты можно настроить внешний вид и поведение.

Примечание

Перед настройкой виджета вам нужно подключить Яндекс Пэй.

Работа с виджетом

Подключение в DOM

paymentSession.mountWidget(
    document.querySelector('<selector>'),
    { widgetType: YaPay.WidgetType.Compact }
)

Удаление из DOM

paymentSession.unmountWidget(
  document.querySelector('<selector>'),
)

Параметры виджета

Параметр Значение Внешний вид
Тип виджета
widgetType YaPay.WidgetType.Mini Mini Auth
widgetType YaPay.WidgetType.BnplOffer BnplOffer Auth Off

BnplOffer Auth On
widgetType YaPay.WidgetType.BnplRequired BnplRequired Auth
widgetType YaPay.WidgetType.Info Info full
Info split
Info cashback
Скругление виджета
borderRadius 0 - 24
Выбор Сплита по умолчанию
bnplSelected true BnplOffer Auth On
bnplSelected false (default) BnplOffer Auth Off

Размеры виджета

Виджет принимает размеры контейнера, в который он встраивается. Но с помощью CSS стилей можно указать ширину контейнера виджета.

Совет

В зависимости от наличия сопроводительных продуктов (оплата в рассрочку и т.д.), виджет может менять свою высоту. По высоте виджет может занимать от 140px до 460px, учитывайте эту особенности при его установке.

<style>
  .ya-pay-widget {
    width: 360px !important;
  }
</style>

Виджет оплаты только через Сплит

Вы можете указать в качестве способа оплаты только оплату через Сплит. В таком случае, если пользователю недоступна оплата через Сплит, виджет будет скрыт.

Совет

Скрытие виджета стоит учитывать при построении дизайна и верстки приложения.

Чтобы включить режим оплаты только через Сплит, добавьте в PaymentData объект строку availablePaymentMethods со списком из одного метода оплаты 'SPLIT':

const paymentData = {
    // ... прочие параметры
    availablePaymentMethods: ['SPLIT'],
};

Пример

Важно

Внешний вид виджета Яндекс Пэй может меняться в зависимости от текущего браузера, результата скоринга, авторизации на ya.ru, наличия аватара или привязанной банковской карты.

Логика отображения виджета

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

Пример расчета

Для клиента с лимитом Сплита 20000 р. стоимость покупки составила 28600 р. При расчете Сплита на четыре платежа в рамках лимита сумма каждого платежа составит 5000 р.

А так как превышающая лимит сумма составляет 28600 - 20000 = 8600 р., то, согласно логике отображения виджета, она будет добавлена к первому платежу. Таким образом, сумма, которую клиент должен будет оплатить в момент покупки в Сплит, составит 8600 + 5000 = 13600 р., как показано на рисунке.

Split Widget Over Limit

Примечание

Размер лимита Сплита может различаться в зависимости от типа и настроек браузера, типа операционной системы и устройства клиента.

Предыдущая
Следующая