创建静态代理续费订单

使用钱包余额为 1～500 个静态代理资源创建续费订单。成功响应表示订单已受理且支付成功，随后进入异步处理。多个资源的续费结果可能不同，订单总体可能为 FAILED；已经续费成功的资源会保留新的到期时间。

接口信息

项目	内容
Method	POST
Path	/open-api/v1/static/renewal-orders
认证	X-API-Key
Content-Type	application/json
处理方式	异步
请求号	必填，保护期 24 小时

请求体

字段	类型	必填	说明	约束
request_no	string	是	仅用于防止重复受理的调用方请求号	1～64 位，仅字母、数字、_、-
resource_ids	string[]	是	需要续费的静态代理资源 ID	去除首尾空白并去重后 1～500 个；全部必须可访问且满足续费条件
duration_days	integer	是	全部资源的统一续费时长	仅 7、30、90；还必须符合下方资源类型组合
callback_url	string	否	订单结束提醒地址	绝对 HTTP/HTTPS 公网地址，最长 2048 个字符

同一续费订单内的全部资源使用相同的 duration_days，可用组合如下：

订单中的资源类型	可用的 duration_days
全部为 ISP	7、30
全部为 ISP_NATIVE	7、30、90
同时包含 ISP 和 ISP_NATIVE	7、30

duration_days 不是 7、30 或 90 时返回 400009。返回 300320 表示资源价格不存在或与请求规格不匹配；实际 msg 按 X-LANG 返回，省略或不支持时使用 en_US。

创建订单前可调用获取静态代理续费报价。报价不锁定价格；本接口仍会重新检查资源状态并按下单时的价格计算订单金额。

请求体不能包含价格、金额、支付方式、优惠信息或其他未列出的字段。

请求示例

curl --request POST \
  --url 'https://api-test.puraroute.com/gin/open-api/v1/static/renewal-orders' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --data '{
    "request_no": "static-renew-20260824-001",
    "resource_ids": [
      "1912345678901234567",
      "1912345678901234568"
    ],
    "duration_days": 30,
    "callback_url": "https://customer.example.com/proxy/order-callback"
  }'

响应参数

字段	类型	说明
order_no	string	静态代理续费订单号
status	string	固定为 PROCESSING
duration_days	integer	续费时长
total_quantity	integer	去重后的资源数量
order_amount	string	订单金额，USD
currency	string	固定为 USD
create_time	string	订单创建时间，GMT+8 ISO-8601

成功响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "order_no": "PO1912345678901234567",
    "status": "PROCESSING",
    "duration_days": 30,
    "total_quantity": 2,
    "order_amount": "16.0000",
    "currency": "USD",
    "create_time": "2026-08-24T15:30:00.000+08:00"
  },
  "next": null
}

可能的错误码

code	说明	建议处理
300001	某个资源不存在或不可访问	重新查询资源并核对 ID
300006	请求号重复	查询续费订单，不要重放
300184	钱包余额不足	补充余额后使用新的请求号重新续费
300320	资源价格不存在或与请求规格不匹配。	—
400001	认证失败	检查 API Key
400009	时长不是 7、30、90，或资源、回调地址、请求体不符合要求	修正请求
500000	系统处理失败，创建结果可能无法确认	先查询续费订单，不要立即使用新请求号再创建

订单受理后如果最终为 FAILED，不会自动退款。已经续费成功的资源仍保留新的到期时间，请联系客户支持人工处理。

创建成功后，保存 order_no 并查询续费详情。回调规则见回调通知。

request_no 仅用于防止重复受理，不是结果查询键，也不会重放第一次结果。详见请求号与重复提交。