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