Запрос возврата, интернет-кредитование

Для возврата средств используется запрос refund.do.

По этому запросу средства по указанному заказу будут возвращены плательщику. Запрос закончится ошибкой в случае, если средства по этому заказу не были списаны.

Для выполнения операции возврата необходимо наличие соответствующих прав в системе.

В настоящем документе при описании параметров запросов и ответов используются следующие обозначения типов данных:

  • A<n> – последовательность латинских букв длины <n>;
  • A..<n> – последовательность латинских букв длиной, не превышающей <n>;
  • N<n> – последовательность цифр длины <n>;
  • N..<n> – последовательность цифр длиной, не превышающей <n>;
  • AN<n> – последовательность латинских букв и цифр фиксированной длины <n>;
  • AN..<n> – последовательность латинских букв и цифр длиной, не превышающей <n>;
  • ANS<n> – последовательность латинских букв, цифр и символов фиксированной длины <n>
  • ANS..<n> – последовательность латинских букв, цифр и символов длиной, не превышающей <n>;
  • UTC – дата и время, при этом: дата должна быть передана без указания часового пояса, время московское, для протокола SOAP используется стандартная кодировка xs:dateTime.

Параметры запроса

Параметры запроса представлены в таблице ниже.

Название Тип Обязательно Описание

userName

AN..30

Да

Логин служебной учётной записи продавца.

password

AN..200

Да

Пароль служебной учётной записи продавца.

orderId

ANS36

Да

Номер заказа в платежной системе. Уникален в пределах системы. Отсутствует если регистрация заказа не удалась по причине ошибки, детализированной в ErrorCode.

amount

N..12

Да

Сумма платежа в минимальных единицах валюты.

orderBundle

Не актуально

Блок, содержащий корзину товаров заказа. Описание его атрибутов представлено ниже.

jsonParams

Строка

Да

Дополнительные параметры запроса. Формат вида: {«Имя1»: «Значение1», «Имя2»: «Значение2»}. При указании «showLoyalty»:«false» взаимодействие с сервисом лояльности осуществляться не будет.

В параметре запрещено передавать зарезервированные имена (в случае их передачи заказ может быть отклонен):

  • sbrf_spasibo:amount_bonus
  • sbrf_sbermiles:amount_bonus
  • loyaltyId
  • overridenClientId

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

Параметры ответа представлены в таблице ниже.

Название Тип Обязательно Описание

errorCode

N..2

Нет

Код ошибки. Может отсутствовать, если результат не привёл к ошибке.

errorMessage

AN..512

Нет

Описание ошибки на языке, переданном в параметре language в запросе.

Коды ошибок

Код ошибки Текст ошибки
0

Обработка запроса прошла без системных ошибок.

5

Доступ запрещён.

5

Пользователь должен сменить свой пароль.

5

[orderId] не задан.

5

Неверная сумма.

6

Неверный номер заказа.

7

Платёж должен быть в корректном состоянии.

7

Неверная сумма возврата (менее одного рубля).

7

Системная ошибка.

Примеры

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

amount=500&currency=643&language=ru&orderId=НОМЕР_ЗАКАЗА&jsonParams={"phone":"79268936532"}&
orderBundle={ "cartItems":  { "items": [  { "positionId": "1",
"name": "Стиральная машина Siemens WS12T460OE", "itemDetails": {},
"quantity": { "value": 1, "measure": "шт" }, "itemAmount": 8000000,
"itemCode": "78864","itemPrice":"8000000" },
{ "positionId": "2", "name": "Услуга - Доставка", "itemDetails": { },
"quantity": { "value": 1, "measure": "шт" }, "itemAmount": 1000000,
"itemCode": "0000","itemPrice": "1000000" },
{ "positionId": "3", "name": "что-то - Доставка", "itemDetails": { },
"quantity": { "value": 1, "measure": "шт" },"itemAmount": 1000000, "itemCode": "0000",
"itemPrice": "1000000" }] } }&installments={"productID":"10","productType":"INSTALLMENT"}}

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

{"errorCode":0}