NAV Navbar
  • YandexCheckoutCreditUI.js
  • Расчет платежа в месяц — метод credit-pre-schedule
  • YandexCheckoutCreditUI.js

    С помощью этой JavaScript-библиотеки можно встроить виджет сервиса Яндекс.Кассы «Заплатить по частям» в свою систему. Библиотека работает как дополнение к Протоколу приема платежей.

    Вы можете выбрать режим отображения виджета — кнопка или информационный блок.

    Кнопку можно встроить только в корзину (когда пользователь выбрал товар). На кнопке отображается реальная сумма ежемесячного платежа. По кнопке пользователь попадает в процесс оформления кредита через Яндекс.Кассу.

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

    Начало работы

    Чтобы начать работу, подключите библиотеку и создайте экземпляр YandexCheckoutCreditUI.

    Подключите библиотеку

    <script src="https://static.yandex.net/kassa/pay-in-parts/ui/v1/"></script>
    

    Создайте экземпляр YandexCheckoutCreditUI

    const $checkoutCreditUI = YandexCheckoutCreditUI(params);
    

    Где params — параметры конфигурации

    Конфигурация

    Пример настройки YandexCheckoutCreditUI

    const $checkoutCreditUI = YandexCheckoutCreditUI({
        shopId: '6677',
        sum: '3000'
    });
    
    Параметр Тип Описание
    shopId long Идентификатор магазина, выдается при подключении к Яндекс.Кассе.
    sum CurrencyAmount Сумма заказа.

    Методы

    Название Описание Принимает Возвращает
    .update Обновляет сумму ежемесячного платежа по кредиту и перерисовывает виджет. {void} {void}
    .on Обработчик событий кнопки (работает для type='button'). submit {void}

    .update

    Используется для вывода виджета.

    $checkoutCreditUI.update();
    

    — желтая кнопка с тегом input type='button'

    const checkoutCreditButton1 = $checkoutCreditUI({
        type: 'button',
        theme: 'default',
        domSelector: '.parent1'
    });
    
    
    
    

    — белая кнопка с тегом input type='submit'

    const checkoutCreditButton2 = $checkoutCreditUI({
        type: 'button',
        tag: 'input',
        theme: 'white',
        domSelector: '.parent2'
    });
    
    
    
    

    — инфоблок

    const checkoutCreditText = $checkoutCreditUI({
        type: 'info',
        domSelector: '.parent3'
    });
    
    Параметр Описание Тип По умолчанию
    domSelector Селектор элемента в коде страницы, в котором будет выводиться виджет (id или class) string {void}
    type Режим отображения виджета. Возможные значения: button (кнопка), info (информационный блок). string button
    tag Тег, в котором выводится кнопка (можно использовать, только если указан type='button'). Возможные значения: button, input. string button
    theme Тема оформления кнопки (можно использовать, только если указан type='button'). Возможные значения: white или default. string default

    Кнопку (type='button') можно настроить:

    .on

    Используется для обработки событий (нажатия на кнопку). Только для type='button'.

    checkoutCreditButton.on('submit', () => {
        alert('Submit');
    });
    

    Пример использования

    const $checkoutCreditUI = YandexCheckoutCreditUI({
        shopId: '6677',
        sum: '3000'
    });
    
    const checkoutCreditButton = $checkoutCreditUI({theme: 'white', type: 'input', domSelector: '.parent'});
    
    checkoutCreditButton.on = function() {
        alert('Submit');
    };
    

    Расчет платежа в месяц — метод credit-pre-schedule

    Этот метод позволяет заранее рассчитывать сумму ежемесячного платежа по кредиту для конкретного товара — при оплате через сервис Яндекс.Кассы «Заплатить по частям».

    Вызов метода

    Запросы отправляются методом GET по протоколу HTTP/1.1.

    Адрес для отправки запросов: https://money.yandex.ru/credit/order/ajax/credit-pre-schedule

    Запрос

    Пример запроса

    https://money.yandex.ru/credit/order/ajax/credit-pre-schedule?shopId=6677&sum=10000
    
    Параметр Тип Описание
    shopId long Идентификатор магазина, выдается при подключении к Яндекс.Кассе.
    sum CurrencyAmount Сумма заказа.

    Параметры ответа

    Пример ответа

    {
        "term":12,
        "creditPercent":"3.90",
        "amount":"1223.33",
        "totalAmount":"14680.00"
    }
    
    Параметр Тип Описание
    term long Срок кредита или рассрочки, количество в месяцах.
    creditPercent long Кредитная ставка (процент в месяц).
    amount CurrencyAmount Сумма платежа в месяц.
    totalAmount CurrencyAmount Полная сумма кредита за весь период с процентами.