Количество бонусных баллов к списанию может передаваться в запросе на регистрацию заказа с предавторизацией. Платёжная страница магазина должна поддерживать отображение количества баллов к списанию.
В этом случае при регистрации заказа помимо обычной суммы в деньгах к списанию (в параметре amount
), должен быть передан дополнительный параметр с именем:
sbrf_spasibo:amount_bonus
- для программы лояльности «Сбербанк Спасибо»;sbrf_sbermiles:amount_bonus
- для программы лояльности «Сбермили».Значение параметра содержит сумму бонусов к списанию в копейках.
Например:
Общая сумма заказа составляет 200 рублей. Чтобы половину суммы оплатить деньгами и половину бонусными баллами, необходимо передать следующие значения параметров:
amount
= 10000 (для списания 100 рублей с банковской карты клиента),sbrf_spasibo:amount_bonus
= 10000 (для списания 100 бонусных балллов с бонусного счёта клиента).ИЛИ
amount
= 10000 (для списания 100 рублей с банковской карты клиента),В остальных параметрах запрос аналогичен обычному запросу регистрации заказа.
Пример запроса:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:mer="http://engine.paymentgate.ru/webservices/merchant"> <soapenv:Header/> <soapenv:Body> <mer:registerOrder> <order bindigId=" " merchantOrderNumber="057a98qerf8kfqdarf" description=" " amount="240000" currency=" " language=" " pageView=" " sessionTimeoutSecs="5400" expirationDate="2016-09-08T14:14:14"> <returnUrl>https://server/applicaton_context/finish.html</returnUrl> <params name="sbrf_spasibo:amount_bonus" value="1030"/> </order> </mer:registerOrder> </soapenv:Body> </soapenv:Envelope>
Пример ответа:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns1:registerOrderResponse xmlns:ns1="http://engine.paymentgate.ru/webservices/merchant"> <return orderId="0271b766-1323-4b82-a7f5-1d34e4f9f3aa" errorCode="0" errorMessage="Успешно"> <formUrl>https://3dsec.sberbank.ru/payment/merchants/rbs/payment_ru.html?mdOrder=0271b766-1323-4b82-a7f5-1d34e4f9f3aa</formUrl> </return> </ns1:registerOrderResponse> </soap:Body> </soap:Envelope>
При регистрации заказа, имея соответствующие настройки лояльности, возможно указать максимальное количество бонусов «Спасибо», доступных для списания у конкретных позиций в товарной корзине.
Для этого необходимо передать параметр sbrf_spasibo:item_max_bonus_amount
в атрибуте items.itemDetails.ItemDetailsParams
. Значение должно быть строго числом больше или равным 0.
Более подробно можно посмотреть описание запроса регистрации заказа с предавторизацией с передачей товарной корзины.
Для того чтобы предоставить клиенту возможность указать количество бонусных баллов на платёжной странице, запрос на регистрацию заказа НЕ должен содержать параметр с количеством бонусов к списанию. Платёжная страница магазина должна поддерживать ввод количества бонусов.
В этом случае запрос аналогичен запросу регистрации заказа.