Инструменты страницы
Запрос на проведение автоплатежа
В настоящем документе при описании параметров запросов и ответов используются следующие обозначения типов данных:
- string – строка;
- array - массив данных;
- object - объект данных;
- data - дата;
- boolean - булевый (логический) тип данных;
- int. (integer) - целочисленный тип данных;
- amount - числовой тип данных (сумма).
Параметры запроса:
Параметр | Тип | Описание | Пример |
---|---|---|---|
| string |
Уникальный номер транзакции на стороне партнёра, необходим для поддержания идемпотентности транзакций. | 7654321DS |
| object |
Объект источника платежа, для передачи можно указать только card или binding. |
|
| object | Объект данных с информацией о карте источнике. | |
| string |
Номер платёжной карты. При указании в запросе параметра seToken этот параметр не обязателен к передаче. | 5647637465647384 |
| date |
Срок действия карты. | 2018-07 |
| string |
Имя держателя карты латиницей, если доступно. Длина поля ограничена 26 символами (латинские буквы, точка, пробел). | IVAN PETROV |
| string |
Код CVC/CVV2 на обратной стороне карты. При указании в запросе параметра seToken этот параметр не обязателен к передаче. | 543 |
| string |
Идентификатор. | 87414E0F13AB4542AA9D10E81F74A6E3 |
| string |
Параметр, определяющий необходимость предварительной авторизации (блокирования средств на счету клиента до их списания). Доступны следующие значения:
Если параметр не указан в запросе, списание происходит сразу, если указан - необходимо отправить отдельный запрос на завершение. | true |
| object |
Объект данных о сумме оплаты. |
|
|
amount |
Сумма оплаты в минорных единицах валюты (61.00 рублей = 6100). | 6100 |
|
amount |
Сумма комиссии по оплате в минорных единицах валюты (1.00 рублей = 100). | 200 |
| string | Валюта оплаты. | 643 |
|
amount |
Сумма баллов «Спасибо» (в штуках баллов). | 59 |
Формат запроса:
POST /api/payment/autopayment HTTP/1.1 Host: web.rbsdev.com/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>" }, "binding":"<binding>" }, "preAuth":<true|false>, "amount":{ "transactionAmount":<transactionAmount>, "transactionFee":<transactionFee>, "currency":"<currency>", "loyaltyPointsAmount":"<loyaltyPointsAmount>" } }
Параметры ответа:
Параметр | Тип | Описание | Пример |
---|---|---|---|
| string |
Номер заказа в платёжном шлюзе. Уникален в пределах платёжного шлюза. | 906bf262-bd53-4ac7-983c-07127954681b |
| string |
Уникальный номер транзакции на стороне партнёра, необходим для поддержания идемпотентности транзакций. | 7654321DS |
| string |
Идентификатор запроса | gbhjnkme-rdcfgv-hbjnkm-7689ui-okp3ew |
| string |
Указание на статус результата обработки запроса | SUCCESS |
Формат ответа:
HTTP/1.1 200 OK Content-Type: application/json Content-Length: <content-lenght> Cache-Control: no-store { "mdOrder":"<mdOrder>", "transactionNumber":"<transactionNumber>", "requestId":"<requestId>", "status": "<status>" }