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

## 请求参数

| 字段           | 类型        | 必填 | 说明                 |
| ------------ | --------- | -- | ------------------ |
| `app_id`     | `string`  | 是  | 应用 ID，在商户平台生成      |
| `timestamp`  | `integer` | 是  | Unix 秒级时间戳，参与请求验签  |
| `to_card_no` | `string`  | 是  | 转入 JCB 卡号          |
| `amount`     | `string`  | 是  | 转账金额               |
| `water_no`   | `string`  | 是  | 商户侧业务流水号，用于幂等和回调匹配 |
| `note`       | `string`  | 否  | 转账备注               |

## 请求示例

```json theme={null}
{
  "app_id": "app_123456",
  "timestamp": 1784880000,
  "to_card_no": "356999******5678",
  "amount": "10.00",
  "water_no": "TRANSFER202607250001",
  "note": "card to card"
}
```

## 返回结果

成功时 `data` 为空字符串。转账最终结果以 JCB 卡对卡转账回调为准。

## 返回示例

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

## 字段规则

* 转出卡由当前 `app_id` 关联商户上下文和服务端配置确定，接口请求体不接收 `from_card_no`。
* 币种不在请求体中传入，按平台配置处理。
* 商户侧必须保证 `water_no` 幂等。