Инструменты страницы
Запрос регистрации заказа с предавторизацией
Передача количества бонусных баллов в запросе на регистрацию заказа
Количество бонусных баллов к списанию может передаваться в запросе на регистрацию заказа с предавторизацией. Платёжная страница магазина должна поддерживать отображение количества баллов к списанию.
В этом случае при регистрации заказа помимо обычной суммы в деньгах к списанию (в параметре amount
), должен быть передан дополнительный параметр с именем:
sbrf_spasibo:amount_bonus
- для программы лояльности «Сбербанк Спасибо»;sbrf_sbermiles:amount_bonus
- для программы лояльности «Сбермили».
Значение параметра содержит сумму бонусов к списанию в копейках.
Например:
Общая сумма заказа составляет 200 рублей. Чтобы половину суммы оплатить деньгами и половину бонусными баллами, необходимо передать следующие значения параметров:
amount
= 10000 (для списания 100 рублей с банковской карты клиента),sbrf_spasibo:amount_bonus
= 10000 (для списания 100 бонусных балллов с бонусного счёта клиента).
ИЛИ
amount
= 10000 (для списания 100 рублей с банковской карты клиента),- sbrf_sbermiles:amount_bonus = 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.
Более подробно можно посмотреть описание запроса регистрации заказа с предавторизацией с передачей товарной корзины.
Ввод количества бонусных баллов на платёжной странице
Для того чтобы предоставить клиенту возможность указать количество бонусных баллов на платёжной странице, запрос на регистрацию заказа НЕ должен содержать параметр с количеством бонусов к списанию. Платёжная страница магазина должна поддерживать ввод количества бонусов.
В этом случае запрос аналогичен запросу регистрации заказа.