Количество бонусных баллов к списанию может передаваться в запросе на регистрацию заказа. Платёжная страница магазина должна поддерживать отображение количества баллов к списанию. В этом случае при регистрации заказа помимо обычной суммы в деньгах к списанию (в параметре amount), должен быть передан дополнительный параметр с именем:
sbrf_spasibo:amount_bonus
- для программы лояльности «Сбербанк Спасибо»;sbrf_sbermiles:amount_bonus
- для программы лояльности «Сбермили».Значение параметра содержит сумму бонусов к списанию в копейках.
Например:
Общая сумма заказа составляет 200 рублей. Чтобы половину суммы оплатить деньгами и половину бонусными баллами, необходимо передать следующие значения параметров:
amount = 10000
(для списания 100 рублей с банковской карты клиента),sbrf_spasibo:amount_bonus = 10000
(для списания 100 бонусных балллов с бонусного счёта клиента).ИЛИ
amount = 10000
(для списания 100 рублей с банковской карты клиента),В остальных параметрах запрос аналогичен обычному запросу регистрации заказа.
Если при регистрации заказа передавать jsonParams={«showLoyalty»:«false»}
, бонусы не будут выводится на платёжной странице.
Пример запроса:
https://3dsec.sberbank.ru/payment/rest/register.do?amount=66600¤cy=643&language=ru&orderNumber=287222222299&password=xxxxx&userName=xxxxx&returnUrl=https://server/applicaton_context/finish.html&jsonParams={"sbrf_spasibo:amount_bonus":"100"}
Пример ответа:
{"orderId":"bc2dd5f9-22b6-42ad-b6ae-0bf87873d75b","formUrl":"https://3dsec.sberbank.ru/payment/merchants/test/payment_ru.html?mdOrder=bc2dd5f9-22b6-42ad-b6ae-0bf87873d75b"}
При регистрации заказа, имея соответствующие настройки лояльности, возможно указать максимальное количество бонусов «Спасибо», доступных для списания у конкретных позиций в товарной корзине.
Для этого необходимо передать параметр sbrf_spasibo:item_max_bonus_amount
в атрибуте items.itemDetails.ItemDetailsParams
. Значение должно быть строго числом больше или равным 0.
Более подробно можно посмотреть описание запроса регистрации заказа с предавторизацией с передачей товарной корзины.
Для того, чтобы предоставить клиенту возможность указать количество бонусных баллов на платёжной странице, запрос на регистрацию заказа НЕ должен содержать параметр с количеством бонусов к списанию. Платёжная страница магазина должна поддерживать ввод количества бонусов.
В этом случае запрос аналогичен обычному запросу регистрации заказа.