续费自有设备

对自有设备执行续费。外壳只需要调用这一个本地 API，前端内部会先查询续费 SKU，再调用支付接口。

调用方式

通过本地 WebSocket 发送 JSON 请求，method 固定为 renewSelfDevice。

{
  "method": "renewSelfDevice"
}

请求参数

参数	类型	是否必填	说明
ipId / selfProxyIpId / deviceId / id	number | string	单个续费必填	自有设备续费使用 selfProxyIpId，也兼容 ipId。
ipIdList / selfProxyIpIdList / deviceIdList / ids	array | string	批量续费必填	批量自有设备 ID 列表，字符串支持逗号、空格、换行分隔。
ipList	array	否	如果外壳已拿到 SKU，可直接传 [{ ipId, ipTypeId, ipTypePriceId, autoReBuy }]。
month / renewMonth	number | string	否	续费月份；不传时默认使用续费详情返回的第一个 SKU。
skuIndex	number	否	按续费详情里的 SKU 下标选择，默认 0。
ipTypeId	number | string	否	指定设备类型 ID。
ipTypePriceId / priceId	number | string	否	指定价格 SKU ID。
payType	number | string	否	支付方式；不传默认 3，表示余额支付。
autoReBuy / autoRebuy / autoRenew	boolean | number	否	是否开启自动续费，1/true 开启，0/false 关闭。
userCouponId / couponIdList / couponIds / couponId	array	否	优惠券 ID 列表。
usePreferentialType	number	否	优惠类型，市场活动为 3。
marketId	number	否	usePreferentialType=3 时传市场活动 ID。
vpsId	number | string	否	单个自有设备存在远程设备时可传。
batch	boolean	否	传 true 时按批量续费流程处理。

请求示例

{
  "method": "renewSelfDevice",
  "selfProxyIpId": 123456,
  "month": 1,
  "payType": 3,
  "autoReBuy": 0
}

{
  "method": "renewSelfDevice",
  "ipIdList": [
    123456,
    123457
  ],
  "month": 1,
  "payType": 3,
  "batch": true
}

{
  "method": "renewSelfDevice",
  "ipList": [
    {
      "ipId": 123456,
      "ipTypeId": 10,
      "ipTypePriceId": 20,
      "autoReBuy": 0
    }
  ],
  "payType": 3
}

返回示例

{
  "method": "renewSelfDevice",
  "response": {
    "code": 200,
    "msg": "success",
    "orderId": 987654,
    "data": 987654,
    "payResult": {
      "code": 200,
      "msg": "success",
      "data": 987654
    },
    "detail": {}
  }
}

说明

• 单个续费内部调用自有设备续费详情接口后，通过 /api/companyOrder/add/v2 下单。
• 批量续费内部调用自有设备批量续费详情接口后，通过 /api/companyOrder/batchReBuy 下单。
• 余额支付失败、余额不足或后端校验失败时，会通过错误返回透出后端 msg。

错误返回

{
  "method": "renewSelfDevice",
  "status": "error",
  "code": "400",
  "msg": "error message"
}