> ## 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/purchase/cap/set` |
| Content-Type  | `application/json`                                    |
| Authorization | 完整 JSON 请求体经 `SHA256withRSA` 签名后再 `BASE64` 编码得到的签名值   |

## 请求参数

| 字段              | 类型        | 必填 | 说明                                                        |
| --------------- | --------- | -- | --------------------------------------------------------- |
| `app_id`        | `string`  | 是  | 应用 ID，在商户平台生成                                             |
| `timestamp`     | `integer` | 是  | Unix 秒级时间戳，参与请求验签                                         |
| `card_no`       | `string`  | 是  | Visa 卡号                                                   |
| `cap_condition` | `string`  | 是  | 限额条件：`online` 线上交易，`offline` 线下交易，`unconditional` 不区分线上线下 |
| `purchase_cap`  | `string`  | 是  | 单笔消费限额金额，币种为账户币种                                          |

## 请求示例

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

## 返回说明

成功时 `data` 为空字符串。

## 返回示例

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