云盘续费订单创建
云盘续费订单创建。
接口地址:
text
/papi/order/cloudDisk/renewal/create请求方式:
text
POST请求数据类型:
text
application/jsonHeader 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-Access-Key | string | 是 | API 访问密钥 ID,鉴权方式见 接口规则 |
| X-Signature | string | 是 | 签名值,Base64 编码的 HMAC-SHA256 计算结果 |
| X-Timestamp | string | 是 | 毫秒级 Unix 时间戳(13 位) |
| X-Nonce | string | 是 | 随机字符串,10~32 位小写字母+数字 |
Body 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| payCode | string | 是 | 支付方式编码;纯钱包支付传 WALLET |
| providerCode | string | 是 | 支付服务商编码;钱包支付传 INTERNAL |
| walletPayAmount | long | 否 | 混合支付时钱包支付金额,单位为美分;须大于 0 且小于订单实付总额 |
| autoRenew | integer | 否 | 自动续费设置:0 关闭、1 开启;省略时保留当前设置 |
| cloudDiskHistorySid | string | 是 | 云盘历史记录 SID |
| skuCode | string | 是 | SKU 编码 |
| packageCode | string | 是 | 套餐编码 |
请求示例:
json
{
"payCode": "wxpayUs",
"providerCode": "Wallyt412",
"cloudDiskHistorySid": "9fpsLp/3/GGJckdj4EL0Jw==",
"skuCode": "j8dmvjz5xy",
"packageCode": "9824e5549x"
}响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | object | 返回数据 |
| ├─ orderNo | string | 订单编号 |
| ├─ qrcodeUrl | string | 二维码 URL |
| ├─ payUrl | string | 支付链接 |
| ├─ payParams | object | 支付参数(用于各种支付方式的特定参数,如APP调起支付参数等) |
| ├─├─ key | object | key |
| ├─ payAmount | integer | 支付金额(美分) |
| ├─ payAmountYuan | number | 支付金额(美元) |
| ├─ walletPayAmount | long | 钱包支付金额(美分) |
| ├─ onlinePayAmount | long | 在线支付金额(美分) |
| ├─ currency | string | 支付币种(USD) |
| ├─ expireTime | integer | 订单过期时间(时间戳) |
| ├─ payMethod | string | 支付方式 |
| ├─ payIcon | string | 支付方式图标 |
| ├─ payType | integer | 支付类型 |
| ├─ payScene | integer | 支付方式 |
| ├─ transactionId | string | 交易 ID |
| ├─ productName | string | 商品名称 |
| ├─ description | string | 订单描述 |
| msg | string | 错误提示 |
响应示例:
json
{
"code": 0,
"data": {
"orderNo": "",
"qrcodeUrl": "",
"payUrl": "",
"payParams": {
"": {}
},
"payAmount": 0,
"payAmountYuan": 0.0,
"walletPayAmount": 0,
"onlinePayAmount": 0,
"currency": "",
"expireTime": 0,
"payMethod": "",
"payIcon": "",
"payType": 0,
"payScene": 0,
"transactionId": "",
"productName": "",
"description": ""
},
"msg": ""
}说明:
- 纯钱包支付:
payCode=WALLET、providerCode=INTERNAL;未传walletPayAmount时使用订单全额支付。混合支付时使用实际在线支付方式并增加walletPayAmount。 cloudDiskHistorySid为云盘购买记录的加密 SID,不能直接使用自动续费策略分页返回的resourceUid数字字符串。autoRenew省略时保留当前设置;尚无自动续费策略时,显式传值按现有续费规则补建策略。
钱包支付规则
纯钱包支付使用 payCode=WALLET、providerCode=INTERNAL;混合支付使用实际在线渠道并传 JSON 整数 walletPayAmount(美分),须大于 0 且小于后台计算的实付总额,不提交 onlinePayAmount。充值订单不能使用钱包或混合支付。支付超时或结果待确认时,先查询原订单和流水;取消或改用钱包支付前,须可靠确认已有在线付款已关闭。符合取消条件时,钱包扣款按原流水返还。
