Skip to content

云盘续费订单创建 ​

云盘续费订单创建。

接口地址:

text
/papi/order/cloudDisk/renewal/create

请求方式:

text
POST

请求数据类型:

text
application/json

Header 参数:

参数类型必填说明
X-Access-Keystring是API 访问密钥 ID,鉴权方式见 接口规则
X-Signaturestring是签名值,Base64 编码的 HMAC-SHA256 计算结果
X-Timestampstring是毫秒级 Unix 时间戳(13 位)
X-Noncestring是随机字符串,10~32 位小写字母+数字

Body 参数:

参数类型必填说明
payCodestring是支付方式编码;纯钱包支付传 WALLET
providerCodestring是支付服务商编码;钱包支付传 INTERNAL
walletPayAmountlong否混合支付时钱包支付金额,单位为美分;须大于 0 且小于订单实付总额
autoRenewinteger否自动续费设置:0 关闭、1 开启;省略时保留当前设置
cloudDiskHistorySidstring是云盘历史记录 SID
skuCodestring是SKU 编码
packageCodestring是套餐编码

请求示例:

json
{
  "payCode": "wxpayUs",
  "providerCode": "Wallyt412",
  "cloudDiskHistorySid": "9fpsLp/3/GGJckdj4EL0Jw==",
  "skuCode": "j8dmvjz5xy",
  "packageCode": "9824e5549x"
}

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataobject返回数据
├─ orderNostring订单编号
├─ qrcodeUrlstring二维码 URL
├─ payUrlstring支付链接
├─ payParamsobject支付参数(用于各种支付方式的特定参数,如APP调起支付参数等)
├─├─ keyobjectkey
├─ payAmountinteger支付金额(美分)
├─ payAmountYuannumber支付金额(美元)
├─ walletPayAmountlong钱包支付金额(美分)
├─ onlinePayAmountlong在线支付金额(美分)
├─ currencystring支付币种(USD)
├─ expireTimeinteger订单过期时间(时间戳)
├─ payMethodstring支付方式
├─ payIconstring支付方式图标
├─ payTypeinteger支付类型
├─ paySceneinteger支付方式
├─ transactionIdstring交易 ID
├─ productNamestring商品名称
├─ descriptionstring订单描述
msgstring错误提示

响应示例:

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。充值订单不能使用钱包或混合支付。支付超时或结果待确认时,先查询原订单和流水;取消或改用钱包支付前,须可靠确认已有在线付款已关闭。符合取消条件时,钱包扣款按原流水返还。

OpenAPI Docs