查询卡详情
GET/openapi/v2/cards| 项 | 内容 |
|---|---|
| 请求方法 | GET |
| 请求路径 | /openapi/v2/cards |
| 请求类型 | query |
请求参数:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
cardId | string | 是 | 卡 ID。 |
响应 data
| 字段 | 类型 | 说明 |
|---|---|---|
cardId | string | 卡 ID。 |
memberId | string | 平台成员 ID。 |
fpCardAccountId | string | FuturePay 平台卡账户 ID。 |
cardTypeId | string | 卡类型 ID;部分历史卡未记录卡类型时可能为空。 |
cardName | string | 卡名称。 |
status | string | 平台卡状态,当前已知值:pending-activation、active、locked、lost、inactive、cancelled、locking、unlocking、unknown;值域可能扩展,历史未映射记录可能保留原始值。 |
embossedName | string | 持卡人姓名。 |
network | string | 卡组织;当前常见值为 VISA、MASTERCARD,产品配置可能扩展。 |
cardType | string | 卡类型;当前已知值为 PHYSICAL、VIRTUAL,产品配置可能扩展。 |
expiryMonth | string | 有效期月份,两位数字 01 到 12。 |
expiryYear | string | 有效期年份,两位或四位数字。 |
last4 | string | 卡号后四位。 |
dailyLimit | string/null | 日限额,币种与卡产品一致。 |
singleTransactionLimit | string/null | 单笔限额,币种与卡产品一致。 |
availableLimit | string/null | 当前可用限额,币种与卡产品一致。 |
cardLimit | string/null | 卡总限额,币种与卡产品一致。 |
cardEmail | string | 卡预留邮箱。 |
限额金额为非科学计数法十进制字符串,例如 "1000"、"1000.5",不保证保留末尾零;卡产品未提供的字段可能为空。
