cards/get
Запрос списка привязанных платежных карт пользователя.
- Метод:
POST - Адрес ресурса:
/api/v1/cards/get
Параметры запроса
| Наменование | Тип | Обязательно | Описание |
|---|---|---|---|
| customer_id | Строка | Да | Идентификатор пользователя в системе продавца |
Параметры ответа
| Наменование | Тип | Обязательно | Описание |
|---|---|---|---|
| status | Строка | Да | Статус запроса - success, error |
| customer_id | Строка | Да(при успешном запросе) | Идентификатор пользователя в системе продавца |
| error | Строка | Нет | Тип ошибки |
| errors | Строка[] | Нет | Описание ошибки(ошибок) |
| cards | Card[] | Да(при успешном запросе) | Массив карт |
Параметры Card
| Наменование | Тип | Обязательно | Описание |
|---|---|---|---|
| card_id | Строка | Да | Id карты в системе эквайринга |
| label | Строка | Да | Последние 4 цифры PAN |
| masked_pan | Строка | Да | Маскированный PAN вида 411111XXXXXX1111 |
| expire_at | Строка | Да | Срок истечения действия карты в формате ГГГГ-ММ |
| issuer | Строка | Да | Код платежной системы |
Платежные системы
| наименование | Код |
|---|---|
| American Express | amex |
| China UnionPay | unionpay |
| Dankort | dankort |
| Diners Club | diners |
| Elo | elo |
| Discover | discover |
| Hipercard | hipercard |
| JCB | jcb |
| Maestro | maestro |
| MasterCard | mastercard |
| MIR | mir |
| Rupay | rupay |
| Solo | solo |
| Switch | switch |
| Visa | visa |
Пример запроса и ответа
Запрос
curl \
-H "Authorization: Bearer hEjM719pNaX6Xp-rF_bCoT564vKQH7GzGL2CZ1iv9mI" \
-H "Signature: 6vWcMfbZEk54Ql2D3fKV1R0SRepUPgwMacFPwfz2H7MEK+h...M9dFWPXkLu4hHb4c64KsyTBp82L2Pm9ggHTjf+A==" \
-H "Content-Type: application/json" \
-d '{ "customer_id": "1" }' \
-X POST https://pay.primorsky.online/api/v1/cards/get
Ответ
{
"status": "success",
"customer_id": "1",
"cards": [
{
"card_id": "8bc20b20-2cb2-73bd-8111-8ac8284861b8",
"label": "1111",
"masked_pan": "411111XXXXXX1111",
"expire_at": "2024-12"
}
]
}