> ## 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/modify/pwd`   |
| 修改手机号  | `POST` | `/mc-platformapi/v1/open/et/vs/card/modify/mob`   |
| 修改邮箱   | `POST` | `/mc-platformapi/v1/open/et/vs/card/modify/email` |

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

## 修改支付密码

| 字段          | 类型        | 必填 | 说明                         |
| ----------- | --------- | -- | -------------------------- |
| `app_id`    | `string`  | 是  | 应用 ID，在商户平台生成              |
| `timestamp` | `integer` | 是  | Unix 秒级时间戳，参与请求验签          |
| `card_no`   | `string`  | 是  | Visa 卡号                    |
| `new_pwd`   | `string`  | 是  | 新支付密码明文；平台会使用 Visa 公钥加密后处理 |

## 修改支付密码请求示例

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

## 修改支付密码返回示例

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

## 修改手机号

| 字段          | 类型        | 必填 | 说明                     |
| ----------- | --------- | -- | ---------------------- |
| `app_id`    | `string`  | 是  | 应用 ID，在商户平台生成          |
| `timestamp` | `integer` | 是  | Unix 秒级时间戳，参与请求验签      |
| `card_no`   | `string`  | 是  | Visa 卡号                |
| `mob_no_of` | `string`  | 是  | 新手机号码国家或地区区号，例如 `+852` |
| `mob_no`    | `string`  | 是  | 新手机号码                  |

## 修改手机号请求示例

```json theme={null}
{
  "app_id": "app_123456",
  "timestamp": 1784880000,
  "card_no": "493875******0990",
  "mob_no_of": "+852",
  "mob_no": "61234567"
}
```

## 修改手机号返回示例

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

## 修改邮箱

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

## 修改邮箱请求示例

```json theme={null}
{
  "app_id": "app_123456",
  "timestamp": 1784880000,
  "card_no": "493875******0990",
  "email": "new-user@example.com"
}
```

## 修改邮箱返回示例

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

## 字段规则

* 修改支付密码和修改邮箱要求卡片属于当前商户且处于激活状态。
* 修改手机号要求卡片属于当前商户；服务端未限制必须为激活状态。
* 修改成功后平台会记录对应修改日志。