Начало перевода

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

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

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

Параметр	Тип	Описание	Пример заполнения
`transactionNumber`	string	Уникальный номер транзакции на стороне партнёра, необходим для поддержания идемпотентности транзакций.	7654321DS
`source`	object	Объект источника платежа, для передачи можно указать только card или binding.
`card`	object	Объект данных с информацией о карте источнике.
`pan`	string	Номер платёжной карты. При указании в запросе параметра seToken этот параметр не обязателен к передаче.	5647637465647384
`expiryDate`	date	Срок действия карты.	2018-07
`cardholderName`	string	Имя держателя карты латиницей, если доступно. Длина поля ограничена 26 символами (латинские буквы, точка, пробел).	IVAN PETROV
`cvc`	string	Код CVC/CVV2 на обратной стороне карты. При указании в запросе параметра seToken этот параметр не обязателен к передаче.	555
`saveSource`	boolean	Указание на сохранение данных карты источника для дальнейшего использования.	true
`binding`	string	Идентификатор связки.	87414E0F13AB4542AA9D10E81F74A6E3
`target`	object	Объект данных получателя перевода, для получения можно указать только `card` или `binding`.
`card`	object	Объект данных с информацией о карте получателе.
`pan`	string	Номер платёжной карты. При указании в запросе параметра seToken этот параметр не обязателен к передаче.	4347637465647384
`saveTarget`	boolean	Указание на сохранение данных карты получателя для дальнейшего использования.	true
`binding`	string	Идентификатор связки.	ABC14E0F13AB4542AA9D10E81F74A6E3
`amount`	object	Объект данных о сумме оплаты.
`transactionAmount`	amount	Сумма оплаты в минорных единицах валюты (61.00 рублей = 6100).	6100
`transactionFee`	amount	Сумма комиссии по оплате в минорных единицах валюты (1.00 рублей = 100).	200
`currency`	string	Валюта оплаты.	643

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

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

   }

}

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

Параметр	Тип	Описание	Пример
`mdOrder`	string	Номер заказа в платёжном шлюзе. Уникален в пределах платёжного шлюза.	906bf262-bd53-4ac7-983c-07127954681b
`transactionNumber`	string	Уникальный номер транзакции на стороне партнёра, необходим для поддержания идемпотентности транзакций.	7654321DS
`info`	string	Результат попытки перевода денежных средств.	Ваш платёж обработан, происходит переадресация…
`redirectUrl`	string	URL-адрес для перенаправления на ACS.	https://test.paymentgate.ru/acs/auth/start.do
`paReq`	string	Параметр для передачи в ACS для прохождения аутентификации.
`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>",
  "mdOrder":"<mdOrder>",
  "info":"<info>",
  "redirectUrl":"<redirectUrl>",
  "paReq":"<paReq>",
  "requestId":"<requestId>",
  "status": "<status>"
}

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

Начало перевода