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



Request to check the available balance of bonus points

If the relevant permissions are enabled, the store may request the balance of Sberbank's «Spasibo» points for a specific user. The request used for this is «getInfo.do».

Only POST is supported.

In this document, the following data type conventions are used when describing request and response parameters:

  • A<n> – a sequence of Latin letters of length <n>;
  • A..<n> – a sequence of Latin letters with a length not exceeding <n>;
  • N<n> – a sequence of digits of length <n>;
  • N..<n> – a sequence of digits with a length not exceeding <n>;
  • AN<n> – a sequence of Latin letters and numbers of fixed length <n>;
  • AN.. <n> – a sequence of Latin letters and numbers with a length not exceeding <n>;
  • ANS<n> – a sequence of Latin letters, numbers and characters of fixed length <n>
  • ANS.. <n> – a sequence of Latin letters, numbers and characters with a length not exceeding <n>;
  • UTC – date and time, in this case: the date must be passed without specifying the time zone, Moscow time, for the SOAP protocol, the standard encoding xs: dateTime is used.

Request parameters:

Name Type Mandatory Description

userName

AN..30

Yes Login issued to the Store upon integration with the Payment Gateway.

password

AN..30

Yes Password issued to the Store upon integration with the Payment Gateway.

pan

N12…19

One of the parameters is required: pan or bindingId.

Payment card number.

bindingId

AN..255

One of the parameters is required: pan or bindingId.

Identifier of the binding created earlier.

Response parameters:

Name Type Mandatory Description

errorCode

ANS..3

No

Error code.

errorMessage

AN..512

No

Error description in the language passed in the language parameter in the request.

minAmount

N..20

No

The minimum amount of bonus points that can be used along with payment for an order.

maxAmount

N..20

No

The maximum amount of bonus points that can be used along with payment for an order. Within one payment, the user cannot spend more points than specified in this parameter.

serviceName

AN..512

No

Bonus program code within the system.

Error codes:

Value Description
0 The request has been processed without system errors.
5 Access denied.
7 System error.

Request example: 

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

Response example: 

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