Change of the displayed card name

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

  • string – string;
  • array – data array;
  • object – data object;
  • data – date;
  • boolean – boolean (logical) data type;
  • int. (integer) – integer data type;
  • amount – a numeric data type (amount).

Request parameters:

Parameter Type Description Example

transactionNumber

string

A unique transaction number on the partner's side is required to maintain idempotence of transactions.

7654321DS
binding object Binding data object.

uuid

string The entity identifier of the specified type, the length is 32 bytes. 87414E0F13AB4542AA9D10E81F74A6E3

mnemonic

string

The new value of the card name specified by the customer.

my very best card

Request format: 

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>"

    }

}

Response parameters:

Parameter Type Description Example

transactionNumber

string

A unique transaction number on the partner's side is required to maintain idempotence of transactions.

7654321DS

requestId

string

Request identifier.

gbhjnkme-rdcfgv-hbjnkm-7689ui-okp3ew

status

string

Indication of the status of the request processing result

SUCCESS

Response format: 

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: <content-lenght>
Cache-Control: no-store

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