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

Запрос на проведение автоплатежа

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

  • 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 этот параметр не обязателен к передаче.

543

binding

string

Идентификатор.

87414E0F13AB4542AA9D10E81F74A6E3

preAuth

string

Параметр, определяющий необходимость предварительной авторизации (блокирования средств на счету клиента до их списания). Доступны следующие значения:

  • true (истина) - параметр включён, оплата происходит с предавторизацией (происходит блокирование средств клиента до списания);
  • false (ложь) - параметр выключен (списание происходит сразу).

Если параметр не указан в запросе, списание происходит сразу, если указан - необходимо отправить отдельный запрос на завершение.

true

amount

object

Объект данных о сумме оплаты.

transactionAmount

amount

Сумма оплаты в минорных единицах валюты (61.00 рублей = 6100).

6100

transactionFee

amount

Сумма комиссии по оплате в минорных единицах валюты (1.00 рублей = 100).

200

currency

string Валюта оплаты. 643

loyaltyPointsAmount

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

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

Параметр Тип Описание Пример

mdOrder

string

Номер заказа в платёжном шлюзе. Уникален в пределах платёжного шлюза.

906bf262-bd53-4ac7-983c-07127954681b

transactionNumber

string

Уникальный номер транзакции на стороне партнёра, необходим для поддержания идемпотентности транзакций.

7654321DS

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>",
  "transactionNumber":"<transactionNumber>",
  "requestId":"<requestId>",
  "status": "<status>"
}