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

Запрос расширенных сведений о связке

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

  • string – строка;
  • array - массив данных;
  • object - объект данных;
  • data - дата;
  • boolean - булевый (логический) тип данных;
  • int. (integer) - целочисленный тип данных;
  • amount - числовой тип данных (сумма).

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

Параметр Тип Описание Пример заполнения

uuid

string

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

87414E0F13AB4542AA9D10E81F74A6E3

responseType

string

Тип запрашиваемых сведений. Возможные значения:

  • balance - информация о балансе (только для препэйд);
  • loyalty - информация по программе лояльности.
balance,loyalty

Формат запроса:

POST /api/bindings/ HTTP/1.1

Host: 3dsec.sberbank.ru/sbersafe

Authorization: <accessToken>

Content-Type: application/json

Accept: application/json; version=1.0

Content-Length: <content-lenght>

 

{

  "uuid":"<uuid>",

  "responseType":"<responseType>"

}

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

Параметр Тип Описание Пример заполнения

balance

string

Объект данных о балансе карты.

amount

amount Баланс карты в минимальных единицах валюты (2312.78 рубля = 231278). 231278

currency

string

Валюта баланса.

643

loyalty

object

Объект информации о баллах «Спасибо».

amountMin

amount

Минимальная сумма баллов «Спасибо» к списанию (в штуках баллов).

10

amountMax

amount

Максимальная сумма баллов «Спасибо» к списанию (в штуках баллов).

100

requestId

string

Идентификатор запроса

gbhjnkme-rdcfgv-hbjnkm-7689ui-okp3ew

status

string

Указание на статус результата обработки запроса

SUCCESS

Формат ответа:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: <content-lenght>
Cache-Control: no-store
 
{
  "balance": {
       "amount":"<amount>",
       "currency":"<currency>"
    },
  "loyalty": { 
       "amountMin": <amountMin>,
       "amountMax": <amountMax> 
     }, 
  "requestId":"<requestId>",
  "status": "<status>"
}