Начало платежа

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

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
`saveCard`	boolean	Указание на сохранение данных карты для дальнейшего использования.	true
`binding`	string	Идентификатор.	87414E0F13AB4542AA9D10E81F74A6E3
`amount`	amount	Объект данных о сумме оплаты.
`transactionAmount`	amount	Сумма оплаты в минорных единицах валюты (61.00 рублей = 6100).	6100
`transactionFee`	amount	Сумма комиссии по оплате в минорных единицах валюты (1.00 рублей = 100).	100
`currency`	string	Валюта баланса.	643
`loyaltyPointsAmount`	string	Сумма баллов «Спасибо» (в штуках баллов).	59
`returnUrl`	object	Объект данных для указания URL для возврата клиента.
`success`	string	URL-адрес в случае успешного завершения операции.	https://success.domain.ru
`fail`	string	URL-адрес в случае неуспешного завершения операции.	https://fail.domain.ru

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

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

        "saveCard":<true|false>

        },

      "binding":"<binding>"

   },

  "amount":{

     "transactionAmount":<transactionAmount>,

     "transactionFee":<transactionFee>,

     "currency":"<currency>",

     "loyaltyPointsAmount":"<loyaltyPointsAmount>"

   }

  "returnUrl":{

     "success":<success>,

     "fail":"<fail>"

   }

}

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

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