Cube API Enterprise (CN) 
在线续费
POST/orders/service适用场景
- 对于通过在线下单新购获取的SIM卡在流量服务到期前或到期后，申请延长SIM卡套餐服务有效期。
必要条件
- 仅支持对所用API key归属企业下的SIM进行操作。
- SIM卡服务合约在有效期内，且不能为废弃期。
- SIM卡的获取途径为通过在线下单下新购单获取。
注意事项
- 续费操作的处理为异步，接口同步响应成功代表领科系统接收请求成功。
- 获取操作异步处理结果的方式：
- 通过续费单号查询续费订单
- 通过notification api回调获取结果
pending - 异步处理时间根据SIM卡数量，运营商系统的网络拥塞情况存在差异，处理时长可达几十分甚至更长。
- 对同一个续费单提交的SIM卡，有可能处理成功或失败,对于处理失败的SIM卡查询时将不返回信息。
- 幂等校验：对10秒内采用相同参数下单，视为同一请求，直接返回原订单号，不做新增处理。
业务规则
- 对于停机保状态的SIM片，续费处理成功后，SIM卡状态将变更为使用期。
- 对于静默期、暂停期状态的SIM片，续费处理成功后，SIM卡状态不变。
SDK API 调用方式
SDK支持版本：1.0.8及以上
PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v2().order().renew(Renew.builder(1).addItem("CP-6HPXRQI88QSM", 2, "89248044404413065327").extra("1235215555", "续费测试").build());
请求参数
Body 参数application/json
items
array [object {3}]
必需
id
string
可选
续费SKU，选填。不传续费SKU时，系统将自动选择可续费SKU进行订购。新购SKU与续费SKU是独立的ID。
quantity
integer
可选
每张卡续费SKU的续费周期数
sim_ids
array[string]
SIM卡ICCID
extra
object
可选
po
string
外部系统订单ID
remarks
string
订单备注
示例
{
"items": [
{
"id": "CP-6HPXRQI88QSM",
"quantity": 2,
"sim_ids": [
"89248044404413065327"
]
}
],
"extra": {
"po": "1235215555",
"remarks": "续费本地测试"
}
}示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
data
object
必需
status
integer
可选
订单状态；1-已创建
created_at
integer
创建时间
order_id
string
订单ID
status
object
必需
code
string
必需
message
string
必需
detail
string
必需
示例
{
"data": {
"status": 1,
"created_at": 1686707689000,
"order_id": "OL-6XB9I9XX8QNR"
},
"status": {
"code": "CB-00-0000",
"message": "成功",
"detail": "https://developer.linksfield.net/doc-1413557?nav=01GBM770ARR76AXBD5856Z6J6P"
}
}最后修改时间： 1 年前