单卡/设备订购套餐包
POST
/openapi/iot/submitPackageOrder单卡/设备订购套餐包,套餐包对接专用。
调用前请确定账户余额充足,可通过接口查询账户资产
查看主账户余额
套餐包编码在哪查看?
1.PC端后台请到【物联卡套餐】中找到【套餐包编码】
2.移动端后台请到【套餐管理】中查看
请求参数
Body 参数application/x-www-form-urlencoded
simNo
string
必需
卡板卡号,设备充值时请传入主卡卡板卡号
示例值:
1929033251
packageId
string
必需
套餐包编码,在套餐包列表中查看
示例值:
22
effectType
string
必需
生效时间 1立即生效,2次月生效
示例值:
1
customNo
string
必需
自定义订单号,对接方的唯一订单号(8-64位数字字母)
示例值:
de7924190818450ae817cbb2e1ce
remark
string
订单备注
示例值:
接口备注
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
0成功,其他失败
code
integer
必需
message
string
必需
data
object
必需
packageId
integer
订购套餐包编码
packageName
string
套餐包名称
packageType
integer
套餐包类型
totalFlow
integer
套餐总流量(KB)
useFlow
integer
必需
套餐已用流量(KB)
effectiveStatus
integer
必需
套餐生效状态,请参考物联卡相关状态码说明
effectiveCycle
integer
必需
套餐生效周期,请参考物联卡相关状态码说明
startAt
string
开始时间
endAt
string
结束时间
orderSn
string
我方订单号
actualPayMoney
integer
订单实付金额
customNo
string
必需
对接方提供的自定义订单号
remark
string
订购备注
timestamp
integer
必需
traceID
string
必需
示例
{
"code": 0,
"message": "操作成功",
"data": {
"packageId": 22,
"packageName": "测试1G叠加包",
"packageType": 3,
"totalFlow": 1048576,
"useFlow": 0,
"effectiveStatus": 1,
"effectiveCycle": 1,
"startAt": "2024-11-01 00:00:00",
"endAt": "2024-12-01 00:00:00",
"orderSn": "SP20241115182300zJOX",
"actualPayMoney": 5,
"customNo": "de7924190818450ae817cbb2e1ce",
"remark": "接口备注"
},
"timestamp": 1731666181,
"traceID": "5831f960804c9217ec01e425b8cc76f5"
}
最后修改时间: 1 天前