Docs
API ЮKassa
Инструкции
Старые версии API
Помощь
Войти
Подключить ЮKassa
Справочник
API ЮKassa: Инструкции
API ЮKassa: Справочник
Старые версии API
Помощь
Войти | Подключить ЮKassa
English

«Покупки в кредит» от СберБанка

Этот способ оплаты доступен, только если:

Особенности
Сценарии интеграции
Готовые решения:
Самостоятельная интеграция: Оплата на готовой странице ЮKassa
О способе оплаты
Кто может оформить кредит
Оформить кредит от СберБанка при оплате покупки могут пользователи с гражданством РФ, у которых есть действующая дебетовая карта СберБанка и доступ к СберБанку Онлайн. Полные и актуальные требования к покупателям
Какие есть тарифы
Есть два типа тарифов — кредит и рассрочка:
  • Кредит (потребительский кредит) — пользователю нужно вернуть СберБанку стоимость покупки с процентами. Вы получите всю стоимость покупки за вычетом комиссии ЮKassa.
  • Рассрочка (кредит без переплат) — проценты уже входят в стоимость покупки, поэтому формально пользователь не платит проценты за использование денег СберБанка. Фактически при оформлении рассрочки вы сделаете скидку с суммы покупки (скидка равна процентам за использование заемных денег). Вы получите стоимость покупки, уменьшенную на сумму скидки, за вычетом комиссии ЮKassa.
Пример: стоимость покупки (сумма платежа) 5 000 рублей, комиссия ЮKassa — 3,5 %.
ТарифСколько пользователь заплатит банкуСколько получите вы
Кредит
Стоимость покупки + проценты банку за использование заемных денег:
5 000 рублей + проценты
Стоимость покупки за вычетом комиссии ЮKassa:
5 000 * (1 - 0,035) = 5 000 * 0,965 = 4 825 рублей
Рассрочка
Стоимость покупки:
5 000 рублей
Стоимость покупки, уменьшенная на сумму скидки СберБанка (например, 10 % от стоимости покупки), за вычетом комиссии ЮKassa:
(5 000 - 500) * (1 - 0,035) = 4 500 * 0,965 = 4 342,5 рублей
Конкретные тарифы и их условия можно узнать у менеджера ЮKassa.
Тарифы вы выбираете при подключении способа оплаты и согласовываете с менеджером. При оплате на платежной форме отображаются все выбранные тарифы, пользователь может выбирать между ними. Подробнее о том, как проходит платеж
Какие есть особенности кредитов и рассрочек
Особенности кредита
  • Сумма платежа не меняется. Вы получите всю стоимость покупки за вычетом комиссии ЮKassa.
  • При частичном подтверждении платежа сумма должна укладываться в лимиты.
  • При частичном подтверждении, отмене и возврате платежа ЮKassa вернет деньги на карту пользователя. Пользователю нужно самостоятельно погасить задолженность в приложении или на сайте СберБанка Онлайн.
Особенности рассрочек
  • Сумма платежа меняется: после успешной оплаты ЮKassa пересчитает сумму, которую вы передали в запросе, с учетом скидки по рассрочке. Вы получите стоимость покупки, уменьшенную на сумму скидки, за вычетом комиссии ЮKassa.
  • При подтверждении, отмене и возврате платежа вам нужно указывать сумму с учетом скидки.
  • При частичном подтверждении платежа сумма должна укладываться в лимиты.
  • При частичном подтверждении, отмене и возврате платежа ЮKassa вернет деньги на карту пользователя. Пользователю нужно самостоятельно погасить задолженность в приложении или на сайте СберБанка Онлайн.
  • Если используете решения ЮKassa для отправки чеков в налоговую, при проведении платежа ЮKassa автоматически пересчитает стоимость товаров в чеке (учтет скидку). При частичном подтверждении или частичном возврате платежа вам нужно самостоятельно пересчитать стоимость товаров и передать данные для чека с учетом скидки.
Подробнее об особенностях рассрочек:
Какие есть лимиты платежей
Лимиты платежей зависят от ограничений СберБанка на сумму выдаваемого кредита. Есть лимиты при создании и при подтверждении платежа.
Лимиты при создании платежа
Минимальная сумма платежа:
  • Для кредита — 3 000 рублей.
  • Для рассрочки — 3 000 рублей плюс сумма максимальной скидки по рассрочке среди выбранных вами тарифов. Пример: если у вас самая большая скидка для рассрочки 10 %, то минимальная сумма платежа — 3 300 рублей (3 000 рублей + скидка 300 рублей).
Максимальная сумма платежа — 1,5 млн рублей.
Лимиты при подтверждении платежа
Минимальная сумма для частичного подтверждения платежа — 3 000 рублей.
Как проходит платеж
При оплате товара пользователь выбирает «Покупки в кредит» от СберБанка и при необходимости тариф — кредит или рассрочку на определенное количество месяцев.
Как это выглядит в разных сценариях интеграции:
Пример платежной формы при использовании Умного платежа
Пример платежной формы при использовании Умного платежа
После этого пользователь переходит в СберБанк Онлайн, где заполняет заявку. Когда СберБанк рассмотрит заявку, он через ЮKassa перечислит вам деньги и перенаправит пользователя обратно к вам на сайт. Подробные схемы, как проходят платежи и возвраты
Тариф, который выбрал пользователь при платеже, и сумму скидки для рассрочек вы узнаете после успешной оплаты. Если оплата прошла успешно (статус платежа waiting_for_capture или succeeded), в объекте платежа в объекте payment_method вернется информация о выбранном тарифе (параметр loan_option) и скидке для рассрочек (объект discount_amount). Для рассрочек сумма платежа в объекте amount изменится на сумму платежа с учетом скидки.
Пример платежа в статусе succeeded (кредит)
JSON
{
  "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1",
  "status": "succeeded",
  "paid": true,
  "amount": {
    "value": "5000.00",
    "currency": "RUB"
  },
  "income_amount": {
    "value": "4825.00",
    "currency": "RUB"
  },
  "captured_at": "2021-06-22T21:44:55.506Z",
  "created_at": "2021-06-22T21:43:44.794Z",
  "description": "Заказ №37",
  "metadata": {
    "order_id": "37"
  },
  "payment_method": {
    "type": "sber_loan",
    "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1",
    "saved": false,
    "loan_option": "loan"
  },
  "recipient": {
    "account_id": "100500",
    "gateway_id": "100700"
  },
  "refundable": true,
  "refunded_amount": {
    "value": "0.00",
    "currency": "RUB"
  },
  "test": true
}
Развернуть
Пример платежа в статусе succeeded (рассрочка)
JSON
{
  "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1",
  "status": "succeeded",
  "paid": true,
  "amount": {
    "value": "4500.00",
    "currency": "RUB"
  },
  "income_amount": {
    "value": "4342.50",
    "currency": "RUB"
  },
  "captured_at": "2021-06-22T21:44:55.506Z",
  "created_at": "2021-06-22T21:43:44.794Z",
  "description": "Заказ №37",
  "metadata": {
    "order_id": "37"
  },
  "payment_method": {
    "type": "sber_loan",
    "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1",
    "saved": false,
    "loan_option": "installments_12",
    "discount_amount": {
      "value": "500.00",
      "currency": "RUB"
    }
  },
  "recipient": {
    "account_id": "100500",
    "gateway_id": "100700"
  },
  "refundable": true,
  "refunded_amount": {
    "value": "0.00",
    "currency": "RUB"
  },
  "test": true
}
Развернуть
Как выглядят сценарии проведения платежа и возврата
Проведение платежа

В этом разделе описан общий порядок проведения платежа и возврата для сценариев Умный платеж и самостоятельная интеграция с оплатой на готовой странице ЮKassa. В выбранном вами сценарии интеграции порядок действий может немного меняться.

Проведение платежа
Проведение платежа
Как проходит платеж:
  1. Пользователь переходит к оплате (например, для Умного платежа нажимает кнопку Заплатить).
  2. Вы создаете платеж — отправляете ЮKassa POST-запрос с учетом выбранного вами сценария интеграции.
  3. ЮKassa возвращает вам созданный объект платежа в статусе pending и со ссылкой на платежную форму (параметр confirmation_url в объекте платежа).
  4. Вы перенаправляете пользователя на страницу оплаты.
  5. Пользователь выбирает нужный ему тариф.
  6. ЮKassa перенаправляет пользователя в СберБанк Онлайн.
  7. Пользователь в СберБанке Онлайн заполняет заявку на кредит в соответствии с выбранным тарифом.
  8. СберБанк рассматривает заявку.
  9. СберБанк сообщает результат ЮKassa и пользователю и перенаправляет пользователя к вам на сайт.
  10. Если пользователь выбрал рассрочку, ЮKassa рассчитает сумму скидки с учетом того тарифа, который выбрал пользователь, и изменит сумму платежа в объекте платежа и в чеках (если вы отправляете чеки в налоговую через ЮKassa).
  11. Если у вас настроены уведомления, ЮKassa присылает уведомление о переходе платежа в статус succeeded (для платежей в одну стадию) или в статус waiting_for_capture (для платежей в две стадии).
  12. Вы запрашиваете информацию о платеже — отправляете ЮKassa GET-запрос с идентификатором платежа.
  13. ЮKassa возвращает вам созданный объект платежа в актуальном статусе.
  14. Вы сообщаете пользователю результат проведения платежа.
Если вы проводите платежи в две стадии, то после получения оплаты от пользователя вам необходимо списать деньги или отменить платеж.
Как подтвердить или отменить платеж в две стадии
Возврат платежа
Проведение возврата
Проведение возврата
Как проходит возврат платежа:
  1. Вы создаете возврат — отправляете ЮKassa POST-запрос с идентификатором платежа и данными о том, какую часть платежа нужно вернуть.
  2. ЮKassa возвращает пользователю указанную сумму.
  3. ЮKassa возвращает вам объект возврата в статусе succeeded.
  4. Вы сообщаете пользователю, что вернули деньги, и предупреждаете, что пользователю необходимо самостоятельно погасить задолженность в СберБанке Онлайн.
  5. Пользователь погашает задолженность.
Как подключить способ оплаты
Проверьте, что вы можете подключить этот способ оплаты:
Чтобы подключить этот способ оплаты:
  1. Сообщите менеджеру ЮKassa, что хотите использовать «Покупки в кредит» от СберБанка.
  2. Выберите нужные вам тарифы из списка, который вам предложит менеджер.
  3. Проинтегрируйтесь с ЮKassa по инструкциям:
  4. При необходимости добавьте дополнительные поля в реестры платежей и возвратов.
  5. Протестируйте интеграцию — проведите платеж на минимальную сумму, затем сделайте возврат.
Готово! Можно принимать платежи от реальных пользователей.
Оплата на готовой странице ЮKassa
Как это работает
В этом сценарии вы самостоятельно реализуете выбор способа оплаты. После создания платежа вы перенаправляете пользователя на страницу ЮKassa. На этой странице отобразится платежная форма с тарифами, которые вы выбрали. По кнопке Кредит от СберБанка пользователь сможет перейти к оформлению потребительского кредита, а в блоке про Рассрочки от СберБанка сможет выбрать нужную ему рассрочку и перейти к ее оформлению.
Пример платежной формы при самостоятельной интеграции
Пример платежной формы при самостоятельной интеграции
Если вы подключили только кредит или только рассрочку, отобразится только одна кнопка с соответствующим названием.
Для интеграции добавьте на ваш сайт кнопку, по которой пользователь перейдет к оплате.

Кнопку и другие элементы управления для выбора этого способа оплаты необходимо сделать в соответствии со стандартами оформления сайта.

Когда пользователь перейдет по кнопке, получите от ЮKassa ссылку на готовую страницу оплаты и перенаправьте на неё пользователя. Когда пользователь вернется обратно к вам на сайт, запросите у ЮKassa результаты платежа.
Как провести платеж
Шаг 1. Когда пользователь выберет «Покупки в кредит» от СберБанка, создайте платеж : отправьте ЮKassa запрос с данными для аутентификации запроса, ключом идемпотентности и данными для платежа:
  • в объекте amount передайте сумму, которую нужно списать с пользователя; сумма должна укладываться в лимиты;
  • в объекте payment_method_data передайте код способа оплаты sber_loan;
  • в объекте confirmation передайте тип redirect и адрес страницы на вашей стороне, на которую пользователь вернется после оплаты (в параметре return_url);
  • в параметре description передайте описание платежа, которое пользователь увидит при оплате.

В запросе можно передать любые другие параметры, кроме save_payment_method, payment_method_id, payment_token, airline, transfers, deal.

Пример запроса
cURL
PHP
Python
curl https://api.yookassa.ru/v3/payments \
  -X POST \
  -u <Идентификатор магазина>:<Секретный ключ> \
  -H 'Idempotence-Key: <Ключ идемпотентности>' \
  -H 'Content-Type: application/json' \
  -d '{
        "amount": {
          "value": "5000.00",
          "currency": "RUB"
        },
        "payment_method_data": {
          "type": "sber_loan"
        },
        "confirmation": {
          "type": "redirect",
          "return_url": "https://www.example.com/return_url"
        },
        "description": "Заказ №37",
        "metadata": {
          "order_id": "37"
        }
      }'
Развернуть
В ответ на запрос вернется объект платежа в актуальном статусе.
Шаг 2. Перенаправьте пользователя на страницу ЮKassa, адрес которой придет в confirmation_url. Это ссылка на страницу ЮKassa, на которой пользователь выберет тариф и перейдет к подтверждению платежа.
Пример тела ответа
JSON
{
  "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1",
  "status": "pending",
  "paid": false,
  "amount": {
    "value": "5000.00",
    "currency": "RUB"
  },
  "confirmation": {
    "type": "redirect",
    "confirmation_url": "https://yoomoney.ru/payments/internal/confirmation?orderId=22c5d0f0-000f-5000-8000-13ece77bc6c1"
  },
  "created_at": "2021-06-22T21:44:55.506Z",
  "description": "Заказ №37",
  "payment_method": {
    "type": "sber_loan",
    "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1",
    "saved": false
  },
  "metadata": {
    "order_id": "37"
  },
  "recipient": {
    "account_id": "100500",
    "gateway_id": "100700"
  },
  "refundable": false,
  "test": false
}
Развернуть
Шаг 3. Дождитесь успешного завершения платежа: подождите, когда придет уведомление от ЮKassa, или периодически отправляйте запросы, чтобы получить информацию о платеже .
Если оплата прошла успешно (статус платежа waiting_for_capture или succeeded), в объекте платежа в объекте payment_method вернется информация о выбранном тарифе (параметр loan_option) и скидке для рассрочек (объект discount_amount). Для рассрочек сумма платежа в объекте amount изменится на сумму платежа с учетом скидки.
Пример платежа в статусе succeeded (кредит)
JSON
{
  "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1",
  "status": "succeeded",
  "paid": true,
  "amount": {
    "value": "5000.00",
    "currency": "RUB"
  },
  "income_amount": {
    "value": "4825.00",
    "currency": "RUB"
  },
  "captured_at": "2021-06-22T21:44:55.506Z",
  "created_at": "2021-06-22T21:43:44.794Z",
  "description": "Заказ №37",
  "metadata": {
    "order_id": "37"
  },
  "payment_method": {
    "type": "sber_loan",
    "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1",
    "saved": false,
    "loan_option": "loan"
  },
  "recipient": {
    "account_id": "100500",
    "gateway_id": "100700"
  },
  "refundable": true,
  "refunded_amount": {
    "value": "0.00",
    "currency": "RUB"
  },
  "test": true
}
Развернуть
Пример платежа в статусе succeeded (рассрочка)
JSON
{
  "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1",
  "status": "succeeded",
  "paid": true,
  "amount": {
    "value": "4500.00",
    "currency": "RUB"
  },
  "income_amount": {
    "value": "4342.50",
    "currency": "RUB"
  },
  "captured_at": "2021-06-22T21:44:55.506Z",
  "created_at": "2021-06-22T21:43:44.794Z",
  "description": "Заказ №37",
  "metadata": {
    "order_id": "37"
  },
  "payment_method": {
    "type": "sber_loan",
    "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1",
    "saved": false,
    "loan_option": "installments_12",
    "discount_amount": {
      "value": "500.00",
      "currency": "RUB"
    }
  },
  "recipient": {
    "account_id": "100500",
    "gateway_id": "100700"
  },
  "refundable": true,
  "refunded_amount": {
    "value": "0.00",
    "currency": "RUB"
  },
  "test": true
}
Развернуть
Шаг 4. Когда пользователь вернется на return_url, отобразите результат проведения платежа (успех или неудача) в зависимости от статуса платежа.
Готово! Если вы проводите платеж в две стадии, подтвердите списание оплаты или отмените платеж. Сообщите пользователю финальный результат платежа.
Особенности проведения платежей в две стадии
Если проводите платежи в две стадии, есть особенности при частичном подтверждении платежа и при отмене платежа:
  • При частичном подтверждении сумма должна укладываться в лимиты.
  • При частичном подтверждении и при отмене платежа ЮKassa вернет деньги на карту пользователя. Предупредите пользователя, что ему необходимо самостоятельно погасить задолженность в приложении или на сайте СберБанка Онлайн. Рекомендуется погасить задолженность как можно скорее, чтобы переплата была как можно меньше или отсутствовала (актуально для всех тарифов, включая рассрочки).
Дополнительно для рассрочек
В запросе на частичное подтверждение платежа указывайте сумму с учетом скидки.
Например, вы создали платеж на сумму 5 000 рублей. Пользователь выбрал рассрочку, скидка составила 10 % (500 рублей). В итоге вы получили 4 500 рублей. Если вы хотите списать, например, только три четверти платежа, подтвердите платеж на 3 375 рублей.
Возвраты платежей
Возврат платежа стандартный.
Срок возврата — от 1 до 3 рабочих дней.
При возврате ЮKassa вернет деньги на карту пользователя. Предупредите пользователя, что ему необходимо самостоятельно погасить задолженность в приложении или на сайте СберБанка Онлайн. Рекомендуется погасить задолженность как можно скорее, чтобы переплата была как можно меньше или отсутствовала (актуально для всех тарифов, включая рассрочки).
Дополнительно для рассрочек
В запросе на возврат платежа указывайте сумму с учетом скидки.
Например, вы создали платеж на сумму 5 000 рублей. Пользователь выбрал рассрочку, скидка составила 10 % (500 рублей). В итоге вы получили 4 500 рублей. Если вы хотите вернуть платеж целиком, сделайте возврат на 4 500 рублей. Если хотите вернуть, например, половину платежа, сделайте возврат на 2 250 рублей.
Отправка чеков в налоговую
Для отправки чеков в налоговую можно использовать решения ЮKassa. Если выбрали кредит, всё проходит стандартно, если выбрали рассрочку, то есть нюансы по поводу стоимости, которую нужно указывать в чеках.
Дополнительно для рассрочек
Чек при оплате
Если при оплате пользователь выбрал рассрочку, то при проведении платежа ЮKassa автоматически пересчитает стоимость товаров в чеке (учтет скидку).
Пример: при создании платежа вы указали такие данные для чека.
ТоварСтоимостьКоличество
Товар 13 000.001
Товар 21 000.002
Общая сумма заказа — 5 000 рублей.
Пользователь выбрал рассрочку, для которой скидка составила 10 % (500 рублей).
ЮKassa пересчитает суммы товаров в чеке.
ТоварСтоимостьКоличество
Товар 12 700.001
Товар 2900.002
Общая сумма заказа — 4 500 рублей.
Чек при частичном подтверждении платежа или при частичном возврате
Если вы делаете частичное подтверждение платежа (при оплате в две стадии) или частичный возврат, вам нужно самостоятельно пересчитать стоимость товаров и передать данные для чека с учетом скидки.
Чтобы это сделать, до проведения платежа сохраните в своей системе перечень выбранных вами тарифов, соответствующие им значения в API и процент скидки.
При проведении частичного подтверждения платежа или частичного возврата:
Шаг 1. Узнайте, какой тариф выбрал пользователь при оплате. Эта информация есть в объекте платежа в параметре payment_method.loan_option.
Шаг 2. Определите процент скидки для этого тарифа.
Шаг 3. Откорректируйте стоимость товаров с учетом скидки. Если нужно округлить значение, используйте математическое округление. Пример:
  • Исходная стоимость товара в чеке: 999,90 руб.
  • Процент скидки: 5 %
  • Сумма скидки: 49,995 руб.
  • Стоимость товара с учетом скидки: 949,905 руб.
  • Стоимость товара с учетом скидки, которую нужно передать в запросе: 949,91 руб.
Шаг 4. Отправьте ЮKassa запрос на частичный возврат или частичное подтверждение, в объекте receipt передайте стоимость товаров с учетом скидки.
Дополнительные поля в реестрах
Вы можете добавить в реестры успешных платежей и возвратов дополнительные поля про тариф кредита и сумму скидки. Как это сделать:
Статья была полезна?
Да
Нет
Что почитать еще
Основы проведения платежей
Неуспешные платежи
Отправка чеков в налоговую
Юридические документы
Правила работы сервиса ЮKassaСоглашение об ЭДО
Вы не разработчик?
Модули для CMSВыставление счетовПлатежи для лендингов
8 800 350-46-56
Задать вопросПомощь
© 2025, ООО НКО «ЮМани»