Инструменты страницы
Запрос создания связки без проведения платежа (createBindingNoPayment.do)
Для создания связки без проведения платежа используется запрос createBindingNoPayment.do.
Для использования этого метода у вас должны быть соответствующие права в системе.
В настоящем документе при описании параметров запросов и ответов используются следующие обозначения типов данных:
- A<n> – последовательность латинских букв длины <n>;
- A..<n> – последовательность латинских букв длиной, не превышающей <n>;
- N<n> – последовательность цифр длины <n>;
- N..<n> – последовательность цифр длиной, не превышающей <n>;
- AN<n> – последовательность латинских букв и цифр фиксированной длины <n>;
- AN..<n> – последовательность латинских букв и цифр длиной, не превышающей <n>;
- ANS<n> – последовательность латинских букв, цифр и символов фиксированной длины <n>
- ANS..<n> – последовательность латинских букв, цифр и символов длиной, не превышающей <n>;
- UTC – дата и время, при этом: дата должна быть передана без указания часового пояса, время московское, для протокола SOAP используется стандартная кодировка xs:dateTime.
Пользуясь протоколом REST, тело сообщения запроса следует отправлять с типом: 'Content-Type: application/x-www-form-urlencoded'.
Параметры запроса
| Название | Тип | Обязательно | Описание |
|---|---|---|---|
|
|
AN..30 | Да |
Логин служебной учётной записи продавца. |
|
|
AN..200 | Да |
Пароль служебной учётной записи продавца. |
|
|
ANS..255 | Да |
Номер (идентификатор) клиента в системе магазина. Используется для реализации функциональности связок. |
|
|
AS..26 | Да |
Имя держателя карты латиницей, если доступно. Длина поля ограничена 26 символами (латинские буквы, точка, пробел). |
|
|
N6 | Да |
Срок истечения действия карты в формате ГГГГММ. Указан только после оплаты заказа. |
|
|
N12…19 | Да |
Номер платёжной карты. При указании в запросе параметра seToken этот параметр не обязателен к передаче. |
|
|
Не актуально | Нет |
Дополнительные параметры заказа, которые сохраняются для просмотра из личного кабинета продавца. Дополнительные параметры следует указывать в следующем формате. «имя_параметра»: «значение_параметра» Каждую новую пару имени и значения параметра следует отделять запятой. Если у продавца настроена фискализация, при указании в качестве дополнительных параметров email (адрес электронной почты покупателя) и/или phone (номер сотового телефона покупателя) эти параметры в первую очередь используются для отправки фискального чека. В параметре запрещено передавать зарезервированные имена (в случае их передачи заказ может быть отклонен):
|
|
|
ANS..255 | Нет |
Чтобы зарегистрировать заказ от имени дочернего продавца, укажите его логин в этом параметре. |
Параметры ответа
| Название | Тип | Обязательно | Описание |
|---|---|---|---|
|
|
N..2 | Да |
Код ошибки. |
|
|
AN..512 | Нет |
Сообщение об ошибке (при ответе с ошибкой). |
|
|
| Нет |
|
|
|
AN..255 | Нет |
Идентификатор связки созданной при оплате заказа или использованной для оплаты. Присутствует только если магазину разрешено создание связок. |
|
|
AS..26 | Нет |
Имя держателя карты латиницей, если доступно. Длина поля ограничена 26 символами (латинские буквы, точка, пробел). |
|
|
ANS..255 | Нет |
Номер (идентификатор) клиента в системе магазина. Используется для реализации функциональности связок. |
|
|
N6 | Нет |
Срок истечения действия карты в формате ГГГГММ. Указан только после оплаты заказа. |
|
|
N..19 | Нет |
Маскированный номер карты, которая использовалась для оплаты. |
Коды ошибок
| Значение | Описание |
|---|---|
| 0 | Обработка запроса прошла без системных ошибок |
| 1 | В запросе не передан обязательный параметр или передан некорректный обязательный параметр |
| 1 | Запрещён доступ к данной функции |
| 1 | Карты платежной системы CUP не поддерживаются при создании связок |
| 1 | У продавца отсутствует разрешение на использование карт JCB |
| 1 | У продавца отсутствует разрешение на использование карт AMEX |
| 1 | У продавца отсутствует разрешение на использование карт Diners Club |
| 1 | У продавца отсутствует разрешение на использование карт Discover |
| 1 | Неверный номер карты |
| 1 | Срок действия карты неверен |
| 1 | Имя держателя карты неверно |
| 1 | Идентификатор клиента неверен |
| 1 | Недопустимая длина ключей дополнительных параметров |
| 1 | Недопустимая длина значений дополнительных параметров |
| 1 | Системная ошибка |
| 1 | Связка уже создана |
Пример запроса
pan=5555555555555599&expiryDate=201912&cardholderName=ANTHONY HOPKINS&clientId=159753456
Пример ответа
{
"maskedPan": "555555**5599",
"expiryDate": "201912",
"cardholderName": "ANTHONY HOPKINS",
"clientId": "159753456",
"bindingId": "47dbe208-e531-4997-9c36-25a5707d3cb9",
"errorCode": 0,
"error": false
}