listCard - Запрос списка зарегистрированных карт
Выполняется с помощью команды listCard.
Этот запрос позволяет получить список карт, хранящихся в theMAP, с целью дальнейшего их использования для оплаты услуг или товаров.
| Название |
Описание |
Формат |
Обязательный |
key |
Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа |
Строка |
Да |
credential |
|
Объект |
Нет |
├─ login |
Логин держателя карты, зарегистрированного в системе Продавца. Используются для получения списка карт сохраненных за пользователем |
Строка (максимум 50 символов) |
Нет |
├─ password |
Пароль держателя карты, зарегистрированного в системе Продавца. Используются для получения списка карт сохраненных за пользователем |
Строка (максимум 50 символов |
Нет |
├─ merchant_name |
Наименование продавца. Используются для получения списка карт сохраненных за Мерчантом |
Строка (максимум 50 символов |
Нет |
├─ merchant_password |
Пароль Мерчанта для совершения операций. Используются для получения списка карт сохраненных за Мерчантом |
Строка (максимум 50 символов |
Нет |
├─ terminal_password |
Пароль терминала для совершения операций. Используются для получения списка карт сохраненных за терминалом |
Строка (максимум 50 символов |
Нет |
| Название |
Описание |
Формат |
Обязательный |
Key |
Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа |
Строка |
Да |
TerminalPassword |
Пароль терминала для совершения операций. Используются для получения списка карт сохраненных за терминалом |
Строка (максимум 50 символов |
Нет |
Login |
Логин держателя карты, зарегистрированного в системе Продавца. Используются для получения списка карт сохраненных за пользователем |
Строка (максимум 50 символов) |
Нет |
Password |
Пароль держателя карты, зарегистрированного в системе Продавца. Используются для получения списка карт сохраненных за пользователем |
Строка (максимум 50 символов |
Нет |
Merchant |
Наименование продавца. Используются для получения списка карт сохраненных за Мерчантом |
Строка (максимум 50 символов |
Нет |
MerchantPassword |
Пароль Мерчанта для совершения операций. Используются для получения списка карт сохраненных за Мерчантом |
Строка (максимум 50 символов |
Нет |
Пример запроса POST:
Content-Type: application/json
https:{domain}/listCard
{
"key": "TestTerminal",
"credential": {
"login": "TestUser",
"password": "123"
}
}
Пример реализации запроса в программном коде:
curl -X POST \
https:https:{domain}/listCard \
-H 'Content-Type: application/json' \
-d '{"key":"TestTerminal","credential":{"login":"TestUser","password":"123"}}'
Пример запроса POST:
Content-Type: application/x-www-form-urlencoded
https:{domain}/listCard
Key : TestTerminal
Login : TestUser
Password : 123
Пример реализации запроса в программном коде:
curl -X POST \
https:https:{domain}/listCard \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'Key=TestTerminal&Login=TestUser&Password=123'
| Название |
Описание |
Формат |
Success |
Флаг успешности операции |
true/false |
CardUId |
Идентификатор удаляемой карты в системе theMAP. Передается, если «Success=true» |
GUID |
PANMask |
Маскированный номер карты в формате 6..4. Передается, если «Success=true» |
Строка 13-19 символов |
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"
}