Инструменты страницы

Запрос проверки доступного баланса бонусных баллов

При наличии соответствующих расширений магазин может запросить баланс баллов «Спасибо» «Сбербанка» для определённого пользователя. Для этого используется запрос getInfo.do.

Поддерживается только POST.

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

  • 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

Да Пароль магазина, полученный при подключении.

bindingId

AN..255

Обязательно присутствие одного из параметров: pan или bindingId.

Идентификатор связки, созданной ранее.

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

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

errorCode

N..2

Нет

Код ошибки.

errorMessage

AN..512

Нет

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

minAmount

N..20

Нет

Минимальная сумма бонусных баллов, которая может быть использована при оплате заказа.

maxAmount

N..20

Нет

Максимальная сумма бонусных баллов, которая может быть использована при оплате заказа. В рамках одного платежа пользователь не может потратить больше баллов, чем указано в этом параметре.

serviceName

AN..512

Нет

Код бонусной программы внутри системы.

Коды ошибок:

Значение Описание
0 Обработка запроса прошла без системных ошибок.
5 Доступ запрещён.
7 Системная ошибка.

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

userName=test-api&password=testPwd&pan=4111111111111111

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

{
    "errorCode": "0",
    "errorMessage": "Success",
    "loyaltyOperations": [
        {
            "serviceName": "sbrf_spasibo",
            "minAmount": 0,
            "maxAmount": 199999485556
        }
    ]
}