Виджеты оплаты Яндекс Пэй
Виджет Яндекс Пэй позволяет встроить на ваш сайт кнопку оплаты вместе с сопроводительными продуктами, которые в совокупности увеличивают конверсию: оплата в рассрочку, информация о кэшбэке.
Для виджета оплаты можно настроить внешний вид и поведение.
Примечание
Перед настройкой виджета вам нужно подключить Яндекс Пэй.
Работа с виджетом
Подключение в DOM
paymentSession.mountWidget(
document.querySelector('<selector>'),
{ widgetType: YaPay.WidgetType.Compact }
)
Удаление из DOM
paymentSession.unmountWidget(
document.querySelector('<selector>'),
)
Параметры виджета
Параметр | Значение | Внешний вид |
---|---|---|
Тип виджета | ||
widgetType |
YaPay.WidgetType.Mini |
![]() |
widgetType |
YaPay.WidgetType.BnplOffer |
![]() ![]() |
widgetType |
YaPay.WidgetType.BnplRequired |
![]() |
widgetType |
YaPay.WidgetType.Info |
![]() ![]() ![]() |
Скругление виджета | ||
borderRadius |
0 - 24 |
|
Выбор Сплита по умолчанию | ||
bnplSelected |
true |
![]() |
bnplSelected |
false (default) |
![]() |
Размеры виджета
Виджет принимает размеры контейнера, в который он встраивается. Но с помощью 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 р., как показано на рисунке.
Примечание
Размер лимита Сплита может различаться в зависимости от типа и настроек браузера, типа операционной системы и устройства клиента.