> ## Documentation Index
> Fetch the complete documentation index at: https://developer.speedpay.hk/llms.txt
> Use this file to discover all available pages before exploring further.

# 卡信息查询

> 查询 Visa 卡基础信息、状态和可用余额。

## 接口信息

| 项目            | 说明                                                  |
| ------------- | --------------------------------------------------- |
| 方法            | `POST`                                              |
| 路径            | `/mc-platformapi/v1/open/et/vs/card/info/query`     |
| Content-Type  | `application/json`                                  |
| Authorization | 完整 JSON 请求体经 `SHA256withRSA` 签名后再 `BASE64` 编码得到的签名值 |

## 请求参数

| 字段          | 类型        | 必填 | 说明                |
| ----------- | --------- | -- | ----------------- |
| `app_id`    | `string`  | 是  | 应用 ID，在商户平台生成     |
| `timestamp` | `integer` | 是  | Unix 秒级时间戳，参与请求验签 |
| `card_no`   | `string`  | 是  | Visa 卡号           |

## 请求示例

```json theme={null}
{
  "app_id": "app_123456",
  "timestamp": 1784880000,
  "card_no": "493875******0990"
}
```

## 返回字段

| 字段                    | 类型        | 说明                   |
| --------------------- | --------- | -------------------- |
| `card_no`             | `string`  | 卡号                   |
| `status`              | `integer` | 卡片状态，已叠加平台管理锁定后的有效状态 |
| `admin_lock`          | `integer` | 平台管理锁定状态             |
| `freeze_amount`       | `string`  | 冻结金额                 |
| `balance_avail`       | `string`  | 可用余额                 |
| `atm_balance_avail`   | `string`  | ATM 可用余额             |
| `atm_day_quota_avail` | `string`  | ATM 当日剩余额度           |
| `currency`            | `string`  | 币种                   |

## 返回示例

```json theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {
    "card_no": "444433******1111",
    "status": 3,
    "admin_lock": 0,
    "freeze_amount": "0",
    "balance_avail": "100.00",
    "atm_balance_avail": "100.00",
    "atm_day_quota_avail": "100.00",
    "currency": "HKD"
  }
}
```