静态IP续费订单创建

为指定代理 IP 创建续费订单，支持纯钱包支付、在线支付和混合支付。仅静态住宅 IP 和静态数据中心 IP 支持续费及自动续费，动态 IP 不适用。

接口地址：

text

/papi/order/ip/renewal/create

请求方式：

text

POST

请求数据类型：

text

application/json

Header 参数：

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

Body 参数：

参数	类型	必填	说明
uid	string	是	代理 IP 的 UID
packageCode	string	是	续费套餐编码
payCode	string	是	支付方式编码；纯钱包支付传 `WALLET`，在线支付传实际支付方式编码
providerCode	string	是	支付服务商编码；钱包支付传 `INTERNAL`
autoRenew	integer	否	自动续费设置：0 关闭、1 开启；省略时保留当前设置
walletPayAmount	long	否	混合支付时的钱包支付金额，单位为美分；须大于 0 且小于订单实付总额

请求示例：

json

{
  "uid": "实际代理IP的uid",
  "packageCode": "实际套餐编码",
  "payCode": "WALLET",
  "providerCode": "INTERNAL",
  "autoRenew": 1
}

响应参数：

参数	类型	说明
code	integer	错误码，参见错误码说明
data	object	返回数据
├─ orderNo	string	关联订单号
├─ payAmount	long	订单实付总额，单位为美分
├─ walletPayAmount	long	钱包支付金额，单位为美分
├─ onlinePayAmount	long	在线支付金额，单位为美分
├─ payUrl	string	支付渠道提供的跳转链接
├─ paymentStatus	integer	支付单状态
├─ fulfillmentStatus	string	履约状态
msg	string	错误提示

响应示例：

json

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

说明：

混合支付时传实际在线 payCode、providerCode 并增加 walletPayAmount，在线支付金额由后端计算；payParams 可按渠道传入。
若该 IP 尚无自动续费策略，显式传 autoRenew 时按现有续费规则补建策略。
自动续费策略也可通过设置自动续费开关管理。

钱包支付规则

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

静态IP续费订单创建 ​

钱包支付规则 ​

静态IP续费订单创建

钱包支付规则