> ## 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.

# 钱包地址

> 查询或创建 JCB 卡绑定的钱包地址。

## 接口信息

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

## 请求参数

| 字段           | 类型        | 必填 | 说明                                |
| ------------ | --------- | -- | --------------------------------- |
| `app_id`     | `string`  | 是  | 应用 ID，在商户平台生成                     |
| `timestamp`  | `integer` | 是  | Unix 秒级时间戳，参与请求验签                 |
| `card_no`    | `string`  | 是  | JCB 卡号                            |
| `brand`      | `string`  | 是  | 链或钱包品牌，例如 `ETH`、`Solana`，按平台支持值传入 |
| `asset_name` | `string`  | 是  | 资产名称，例如 `USDT`、`USDC`             |

## 请求示例

```json theme={null}
{
  "app_id": "app_123456",
  "timestamp": 1784880000,
  "card_no": "356999******1234",
  "brand": "ETH",
  "asset_name": "USDT"
}
```

## 返回字段

| 字段        | 类型       | 说明   |
| --------- | -------- | ---- |
| `address` | `string` | 钱包地址 |

## 返回示例

```json theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {
    "address": "0x1234567890abcdef1234567890abcdef12345678"
  }
}
```

## 字段规则

* 卡片必须属于当前商户。
* 卡片状态必须为已激活、商户锁定或平台锁定中的一种。
* 如果本地不存在该 `card_no` + `brand` 的钱包地址，系统会创建并保存。