续费静态实例
用业务编号批量受理实例续费并查询最终结果。
只只HTTP技术团队维护更新于 2026年10月6日
接口与认证
POST
/openapi/v1/static/instances/renew受理批量续费。仅访问当前令牌账户的数据。
使用 HTTPS 和账户 API 令牌。响应包含 Cache-Control: no-store 和 X-Request-Id。
示例为合成数据与占位凭据,仅说明结构。接口合同不代表目标环境已开放,开放状态以控制台为准。
下载 OpenAPI · 导入 Apifox / Postman请求参数
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
api_key | string | 是 | Query · 唯一非空 | 账户 API 令牌,在受控服务端保存;示例使用占位符。 |
请求示例 · application/json
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
clientOperationNo | string | 是 | 格式 ^[A-Za-z0-9_.-]{1,64}$ | 客户操作编号,1–64 位字母、数字、_、.、-;同编号不同参数返回 HTTP 200 / 业务码 10705。 |
instanceIds | integer[] | 是 | 最少项 1;最多项 100 | 本人实例 ID 数组,每次 1–100 项;任一实例无效则整批拒绝。 |
durationDays | integer | 是 | 最小 1;最大 3650 | 期限天数;须满足商品/实例 capabilities 中对应期限规则。 |
expectedTotalAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
请求示例
curl --request POST \
"https://api.zzhttp.com/openapi/v1/static/instances/renew?api_key=${STATIC_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"clientOperationNo":"platform-renew-001","instanceIds":[101],"durationDays":30,"expectedTotalAmountCents":3500}'成功响应
异步受理,请查询最终状态
响应不包含代理密码,凭据仅由专用接口返回。
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
code | integer | 是 | 固定 200 | 统一数字业务码:HTTP 与业务码成功均为 200;异步受理不代表交付完成。 |
message | string | 是 | — | 服务端结果说明。 |
requestId | string | 是 | — | 本次请求的追踪 ID,用于排障,不是业务幂等编号。 |
data | object | 是 | — | 本接口业务数据。 |
data.operationId | integer | 是 | 最小 1;格式 int64 | 平台操作 ID。 |
data.clientOperationNo | string | 是 | — | 客户操作编号,1–64 位字母、数字、_、.、-;同编号不同参数返回 HTTP 200 / 业务码 10705。 |
data.type | string | 是 | — | 操作/事件类型。 |
data.status | string | 是 | 枚举 accepted / processing / succeeded / partial / failed / manual_review | 当前状态;枚举见限制,按逐项结果确认终态。 |
data.totalAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.currency | string | 是 | 固定 CNY | 金额币种,当前合同为 CNY。 |
data.settlement | object | 是 | — | 逐订单资金结算;钱包原冻结 = 当前冻结 + 已扣 + 已释放。 |
data.settlement.fundingSource | string | 否 | 枚举 wallet / external / none | 资金来源:wallet 钱包,external 历史外部支付,none 未付款或免费。 |
data.settlement.external | object | 否 | — | 历史外部支付结算信息,不能把应退当已退。 |
data.settlement.external.paidAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.external.capturedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.external.unsettledAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.external.refundDueAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.external.refundedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.external.refundPendingAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.reservedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.frozenAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.capturedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.releasedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.gift | object | 否 | — | 赠送余额的冻结、扣除与释放。 |
data.settlement.gift.reservedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.gift.capturedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.gift.releasedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.recharge | object | 否 | — | 充值余额的冻结、扣除与释放。 |
data.settlement.recharge.reservedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.recharge.capturedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.settlement.recharge.releasedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items | object[] | 是 | — | 结果或提交明细数组,具体字段见下级。 |
data.items[].instanceId | integer | 是 | 最小 1;格式 int64 | 实例 ID,属于当前账户;分组绑定此 ID。 |
data.items[].status | string | 是 | 枚举 accepted / processing / succeeded / partial / failed / manual_review | 当前状态;枚举见限制,按逐项结果确认终态。 |
data.items[].amountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].frozenAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].capturedAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].releasedAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].errorCode | string | 是 | — | 逐项原因:OUT_OF_STOCK、SERVICE_UNAVAILABLE、RESULT_UNCONFIRMED、FULFILLMENT_FAILED;成功为空字符串。 |
data.items[].completedAt | string | null | 是 | 格式 date-time | 完成时间,RFC3339;未结束为 null。 |
data.items[].errorMessage | string | 否 | — | 失败原因说明。 |
data.items[].nextAction | string | 否 | 枚举 / check_inventory / query_order / contact_support | 建议下一步;结果不确定时只能查原单。 |
data.createdAt | string | null | 是 | 格式 date-time | 创建时间,RFC3339。 |
data.completedAt | string | null | 是 | 格式 date-time | 完成时间,RFC3339;未结束为 null。 |
data.queryUrl | string | 是 | — | 轮询查询的相对路径,仍需附加 api_key 认证。 |
data.orderNo | string | 否 | — | 关联收费订单号;无收费订单时省略 |
{
"code": 200,
"message": "成功",
"requestId": "00000000-0000-4000-8000-000000000001",
"data": {
"operationId": 301,
"clientOperationNo": "platform-renew-001",
"type": "renewal",
"status": "accepted",
"totalAmountCents": 3500,
"currency": "CNY",
"settlement": {
"fundingSource": "wallet",
"reservedAmountCents": 3500,
"frozenAmountCents": 3500,
"capturedAmountCents": 0,
"releasedAmountCents": 0,
"gift": {
"reservedAmountCents": 0,
"capturedAmountCents": 0,
"releasedAmountCents": 0
},
"recharge": {
"reservedAmountCents": 3500,
"capturedAmountCents": 0,
"releasedAmountCents": 0
}
},
"items": [
{
"instanceId": 101,
"status": "accepted",
"amountCents": 3500,
"frozenAmountCents": 3500,
"capturedAmountCents": 0,
"releasedAmountCents": 0,
"errorCode": "",
"completedAt": null,
"errorMessage": "",
"nextAction": ""
}
],
"createdAt": "2026-10-06T08:00:00Z",
"completedAt": null,
"queryUrl": "/openapi/v1/static/operations/301",
"orderNo": "STATIC-RENEW-DEMO-001"
}
}错误与重试
HTTP 200 / code 200 仅表示受理。超时或 500 先按原 clientOrderNo/clientOperationNo 查询;不要更换编号重复交易。同编号不同参数为 200 / 10705。
错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。
这篇内容解决了你的问题吗?
反馈只用于改进公开文档,不会提交账号或请求信息。