Start of transfer

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	Value example
`transactionNumber`	string	A unique transaction number on the partner's side is required to maintain idempotence of transactions.	7654321DS
`source`	object	The object of the payment source, only «card» or «binding» can be specified for passing.
`card`	object	Data object with information about the source card.
`pan`	string	Payment card number.	5647637465647384
`expiryDate`	date	The validity of the card.	2018-07
`cardholderName`	string	Cardholder's name in Latin characters, if available.	IVAN PETROV
`cvc`	string	CVC/CVV2 code on the back of the card.	555
`saveSource`	boolean	Indication on the save of the source card data for future use.	true
`binding`	string	Binding identifier.	87414E0F13AB4542AA9D10E81F74A6E3
`target`	object	Data object of the transfer recipient, for which only `card` or `binding` can be specified.
`card`	object	Data object with the information about the recipient card.
`pan`	string	Payment card number.	4347637465647384
`saveTarget`	boolean	Indication of saving the recipient 's card data for the future use.	true
`binding`	string	Binding identifier.	ABC14E0F13AB4542AA9D10E81F74A6E3
`amount`	object	Data object about the amount of payment.
`transactionAmount`	amount	Payment amount in minor currency units (61.00 rubles = 6100).	6100
`transactionFee`	amount	The amount of the commission for payment in minor currency units (1.00 rubles = 100).	200
`currency`	string	Payment currency.	643

Request format:

POST /api/transfer/start 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>",

  "source":{

        "card":{

            "pan":"<pan>",

            "expiryDate":"<expiryDate>",

            "cardholderName":"<cardholderName>",

            "cvc":"<cvc>",

            "saveSource":<true|false>

            },

        "binding":"<uuid>"

   },

  "target":{

        "card":{

            "pan":"<pan>",

            "saveTarget":<true|false>

            },

        "binding":"<uuid>"

   },

  "amount":{

     "transactionAmount":<amount>,

     "transactionFee":<fee>,

     "currency":"<currency>",

   }

}

Response parameters:

Parameter	Type	Description	Example
`mdOrder`	string	Order number in the payment gateway. Unique within the payment gateway.	906bf262-bd53-4ac7-983c-07127954681b
`transactionNumber`	string	A unique transaction number on the partner's side is required to maintain idempotence of transactions.	7654321DS
`info`	string	Result of an attempt to transfer funds.	Your payment has been processed, redirecting.
`redirectUrl`	string	URL address for redirecting to ACS.	https://test.paymentgate.ru/acs/auth/start.do
`paReq`	string	Parameter to pass to ACS for authentication.
`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>",
  "mdOrder":"<mdOrder>",
  "info":"<info>",
  "redirectUrl":"<redirectUrl>",
  "paReq":"<paReq>",
  "requestId":"<requestId>",
  "status": "<status>"
}

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

Start of transfer