Skip to content

静态IP续费订单创建 ​

为静态 IP 创建续费订单;纯钱包支付使用 payCode=WALLET、providerCode=INTERNAL,混合支付使用实际在线支付方式并额外传 walletPayAmount。静态住宅 IP 与静态数据中心 IP 支持续费,动态 IP 不适用。

接口地址:

text
/papi/order/ip/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 参数:

参数类型必填说明
uidstring是代理 IP 的 UID
packageCodestring是续费套餐编码
payCodestring是支付方式编码;纯钱包支付使用 WALLET
providerCodestring是支付服务商编码;纯钱包支付使用 INTERNAL
autoRenewinteger否自动续费设置(0-关闭,1-开启),省略或为 null 时保留当前设置
walletPayAmountinteger否混合支付时的钱包支付金额(美分),须大于 0 且小于订单实付总额
payParamsobject否支付渠道参数

请求示例:

json
{
  "uid": "ip-uid-001",
  "packageCode": "jeur2yj52s",
  "payCode": "WALLET",
  "providerCode": "INTERNAL",
  "autoRenew": 1
}

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataobject返回数据
├─ orderNostring订单编号
├─ payAmountinteger订单实付总额(美分)
├─ walletPayAmountinteger钱包支付金额(美分)
├─ onlinePayAmountinteger在线支付金额(美分)
├─ payUrlstring支付链接
├─ paymentStatusinteger支付单状态
├─ fulfillmentStatusstring履约状态
msgstring错误提示

响应示例:

json
{
  "code": 0,
  "data": {
    "orderNo": "",
    "payAmount": 0,
    "walletPayAmount": 0,
    "onlinePayAmount": 0,
    "payUrl": "",
    "paymentStatus": 0,
    "fulfillmentStatus": ""
  },
  "msg": ""
}

钱包支付规则 ​

纯钱包支付使用 payCode=WALLET、providerCode=INTERNAL;混合支付使用实际在线渠道并传 JSON 整数 walletPayAmount(美分),须大于 0 且小于后台计算的实付总额,不提交 onlinePayAmount。充值订单不能使用钱包或混合支付。支付超时或结果待确认时,先查询原订单和流水;取消或改用钱包支付前,须可靠确认已有在线付款已关闭。符合取消条件时,钱包扣款按原流水返还。

Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone 帮助中心