1. 获取产品套餐规格和价格
查询套餐规格和渠道价格,packageNo 可用于提单确认规格。
请求
GET /api/isv/v1/org/packages
无额外参数。
返回结果
{
"code": 0,
"message": "成功",
"data": [
{
"packageNo": "CP001xxx", // 套餐编号(提单时传入)
"packageName": "标准版", // 套餐名称
"productType": "SKB", // 套餐类型:【常规】可新开/续费/升级;【增量】增加工号/流量额度;
"quantityType": "工号", // 数量字段类型:工号、流量等
"quantity": "20", // 工号数量/流量额度
"duration": "12", // 时长(单位:月)
"amount": "10000.00" // 按渠道价格扣预存款(元,字符串)
}
],
"traceId": "..."
}
2. 提单
为已注册的账号开通产品套餐,第一次提单为新开,再次提单同一个规格为续期,购买不同规格为升级,扣款会自动计算差价。
订单类型:新开、升级、续费、增购的说明:
1、【标准规格】包含线索量、工号和时长三个维度;多次购买同规格为续期;买不同标准规格为升级,不延长时间;需补差价。
2、【增量规格】需先购买标准规格再买增量规格;增量规格只增加额度或工号,不增加时长,到期时间跟随最近到期的那个套餐时间;
3、套餐额度以年为单位,订单到期后额度清零(不跟随续费订单到下一个周期内)。
请求
POST /api/isv/v1/org/orders
Content-Type: application/json
| 字段 | 必填 | 说明 |
|---|---|---|
oid |
是 | 登录用户在我们系统的企业账号 ID |
packageNo |
是 | 套餐编号,见产品套餐接口 |
orderNo |
是 | 你们系统的唯一订单号(若没有,可传uuid做为唯一值) |
startedAt |
否 | 开通日期 yyyy-mm-dd,默认当天 |
返回结果
{
"code": 0,
"message": "成功",
"data": {
"number": "DD20250101385302", // 我们系统内唯一的订单编号
"orderType": "增购", // 订单类型:新开、升级、续费、增购(变更常规套餐/加工号多为升级;流量包多为增购)
"quantity": "20", // 订单工号/数量
"duration": "12", // 订单时长(单位:月)
"startedAt": "2025-04-16 00:00:00", // 当前订单开始时间
"expiredAt": "2026-04-16 23:59:59", // 当前订单到期时间
"amount": "1000.00" // 扣款金额(元,字符串)
},
"traceId": "..."
}
文档更新时间: 2026-09-16 23:42 作者:004