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

Запрос списка связок определённой банковской карты (getBindingsByCardOrId.do)

При наличии соответствующих разрешений магазин может запросить список всех связок, относящихся к определённой банковской карте. Сделать это можно по номеру карты или по известному идентификатору связки. Для получения списка связок банковской карты используется метод getBindingsByCardOrId.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'.

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

Название Тип Обязательно Описание

userName

AN..30

Да

Логин служебной учётной записи продавца.

password

AN..200

Да

Пароль служебной учётной записи продавца.

pan

N12…19

Обязательно, если не указан bindingId.

Номер платёжной карты.

При указании в запросе параметра seToken этот параметр не обязателен к передаче.

bindingId

AN..255

Обязательно, если не указан pan.

Идентификатор созданной ранее связки. Может использоваться, только если у продавца есть разрешение на работу со связками. Если этот параметр передаётся в данном запросе, то это означает:
1. Данный заказ может быть оплачен только с помощью связки;
2. Плательщик будет перенаправлен на платёжную страницу, где требуется только ввод CVC.

showExpired

булеан

Нет

Параметр определяет необходимость отображать связки с истёкшим сроком действия карты. Возможные значения: true, false. По умолчанию параметр принимает значение false.

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

Название Тип Обязательно Описание

errorCode

N..2

Да

Код ошибки. Может отсутствовать, если результат не привёл к ошибке.

errorMessage

AN..512

Да

Описание ошибки на языке, переданном в параметре language в запросе.

Элемент bindings (содержит блоки, состоящие из параметров bindingId, maskedPan, expiryDate и clientId).

bindingId

AN..255

Нет

Идентификатор созданной ранее связки. Может использоваться, только если у продавца есть разрешение на работу со связками. Если этот параметр передаётся в данном запросе, то это означает:
1. Данный заказ может быть оплачен только с помощью связки;
2. Плательщик будет перенаправлен на платёжную страницу, где требуется только ввод CVC.

maskedPan

N..19

Нет

Маскированный номер карты, которая использовалась для оплаты.

expiryDate

N6

Нет

Срок истечения действия карты в формате ГГГГММ. Указан только после оплаты заказа.

clientId

ANS..255

Нет

Номер (идентификатор) клиента в системе магазина. Используется для реализации функционала связок. Может присутствовать, если магазину разрешено создание связок.

Указание этого параметра при платежах по связке необходимо - в противном случае платёж будет неуспешен.

Коды ошибок

Код ошибки Текст ошибки
0

Обработка запроса прошла без системных ошибок.

1

Параметры поиска [pan] или [bindingId] не заданы.

2

Информация не найдена.

5

Доступ запрещён.

5

Пользователь должен сменить свой пароль.

7

Системная ошибка.

Примеры

Пример запроса

userName=login&password=password&pan=4111111111111111

Пример ответа

{"errorCode":"0","errorMessage":"Успешно","bindings":[{"bindingId":"0b8edeb2-8380-4092-bf7e-1e1a78f2b15e","maskedPan":"411111**1111","expiryDate":"201912","clientId":"12"},{"bindingId":"6a8c0738-cc88-4200-acf6-afc264d66cb0","maskedPan":"411111**1111","expiryDate":"201912","clientId":"666"},{"bindingId":"97a70989-c1fb-49f7-8a42-27c19dc160dw","maskedPan":"411111**1111","expiryDate":"201512","clientId":"666"}]}