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

Изменение отображаемого названия карты

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

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

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

Параметр Тип Описание Пример

transactionNumber

string

Уникальный номер транзакции на стороне партнёра, необходим для поддержания идемпотентности транзакций.

7654321DS
binding object Объект данных связки.

uuid

string Идентификатор сущности указанного типа, длина 32 байта. 87414E0F13AB4542AA9D10E81F74A6E3

mnemonic

string

Новое значение названия карты, заданное клиентом.

my very best card

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

POST /api/change HTTP/1.1

Host: 3dsec.sberbank.ru/sbersafe

Authorization: <accessToken>

Content-Type: application/json

Accept: application/json; version=1.0

Content-Length: <content-lenght>

 

{

  "transactionNumber": "<transactionNumber>",

  "binding": {

    "uuid": "<uuid>",

    "mnemonic": "<mnemonic>"

    }

}

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

Параметр Тип Описание Пример

transactionNumber

string

Уникальный номер транзакции на стороне партнёра, необходим для поддержания идемпотентности транзакций.

7654321DS

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

{
  "transactionNumber": "<transactionNumber>",
  "requestId": "<requestId>",
  "status": "<status>"
}