listCard - Запрос списка зарегистрированных карт
Выполняется с помощью команды listCard.
Этот запрос позволяет получить список карт, хранящихся в theMAP, с целью дальнейшего их использования для оплаты услуг или товаров.
| Название |
Описание |
Формат |
Обязательный |
| Key* |
Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа |
Строка |
Нет |
| TerminalPassword** |
Пароль терминала для совершения операций |
Строка (максимум 50 символов |
Нет |
| Login*** |
Логин Пользователя. Используется для идентификации карт |
Строка (максимум 50 символов) |
Нет |
| Password*** |
Пароль держателя карты, зарегистрированного в системе Продавца |
Строка (максимум 50 символов |
Нет |
| Merchant**** |
Наименование продавца |
Строка (максимум 50 символов |
Нет |
| MerchantPassword**** |
Пароль Мерчанта для совершения операций |
Строка (максимум 50 символов |
Нет |
* - Используется для запроса списка карт, сохраненных за терминалом или за Пользователем
** - Используется для запроса списка карт, сохраненных за терминалом
*** - Используется для запроса списка карт, сохраненных за Пользователем
**** - Используется для запроса списка карт, сохраненных за Мерчантом
Пример запроса POST:
https://{domain}/listCard
Login : TestUser
Password : 123
Пример реализации запроса в программном коде:
curl -X POST \
https://https://{domain}/listCard \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'Login=TestUser&Password=123&CardUId=456ceFOFYXmjlZraP12nfP'
| Название |
Описание |
Формат |
| Success |
Флаг успешности операции |
true/false |
| CardUId |
Идентификатор удаляемой карты в системе theMAP. Передается, если «Success=true» |
GUID |
| PANMask |
Маскированный номер карты в формате 6..4. Передается, если «Success=true» |
Строка 13-19 символов |
| BankName |
Параметр является опциональным. Наименование банка-эмитента |
Строка, 50 символов |
| CardHolder |
Фамилия, имя держателя карты, указанные на лицевой стороне карты |
Строка, 50 символов |
| Status |
Статус карты. Active – карта активна и может быть использована для списаний. Передается, если «Success=true» |
Строка, 50 символов |
| ErrCode |
Код ошибки. Не передается, если «Success=true» |
см. коды ошибок |
Пример ответа на успешный запрос:
{
"PanMask": "411111xxxxxx1111",
"CardUId": "Gnxs8dXqhObnvKwy38djkG",
"EMonth": 12,
"EYear": 21,
"Status": "Active",
"CardHolder": "Ivan Ivanov"
},
{
"PanMask": "411111xxxxxx0023",
"CardUId": "flsWu82F7j8UUMmbcPws89Nx3",
"EMonth": 12,
"EYear": 22,
"Status": "Active",
"CardHolder": "Ivan Ivanov"
}
Пример ответа на не успешный запрос:
{
"Success": false,
"ErrCode": "INVALID_AUTHENTICATION"
}