> ## 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/card/fee/setting` |
| 手续费查询 | `POST` | `/mc-platformapi/v1/open/jcb/card/fee/get`     |

所有接口均使用 `application/json`，并在 `Authorization` Header 中传入完整 JSON 请求体的 `SHA256withRSA` + `BASE64` 签名值。

## 手续费设置参数

| 字段          | 类型              | 必填 | 说明                |
| ----------- | --------------- | -- | ----------------- |
| `app_id`    | `string`        | 是  | 应用 ID，在商户平台生成     |
| `timestamp` | `integer`       | 是  | Unix 秒级时间戳，参与请求验签 |
| `fee_rate`  | `string`        | 是  | 商户设置的手续费率         |
| `card_no`   | `array<string>` | 是  | 需要设置费率的卡号数组       |

## 手续费设置请求示例

```json theme={null}
{
  "app_id": "app_123456",
  "timestamp": 1784880000,
  "fee_rate": "0.01",
  "card_no": ["356999******1234"]
}
```

## 手续费设置返回示例

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

## 手续费查询参数

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

## 手续费查询返回字段

| 字段               | 类型       | 说明              |
| ---------------- | -------- | --------------- |
| `card_no`        | `string` | JCB 卡号          |
| `percentage_fee` | `string` | 百分比费用，保留原始字符串格式 |

## 手续费查询请求示例

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

## 手续费查询返回示例

```json theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {
    "card_no": "356999******1234",
    "percentage_fee": "0.01"
  }
}
```