pop-parent 接口文档

更新时间：2026-04-29 16:23:12

保存在线自定义续费套餐信息

接口地址

POST /pcs/v1/customer/online-custom-package/save

接口说明

保存在线自定义续费套餐信息，并发起后续审批流程。

请求头

Content-Type: application/json

请求参数

字段名	类型	必填	说明
`id`	`Long`	否	为空表示新增，有值表示修改
`customerId`	`String`	是	客户 ID
`status`	`String`	是	状态，建议传 `audit`
`ext`	`String`	是	自定义套餐详情 JSON 字符串
`createUserId`	`String`	否	前端无需传，系统自动取当前登录人 `saleUserId`

说明：

如果当前登录用户 saleUserId 为空，接口会直接报错。
实际保存时，下游会将状态重置为 audit。
如果该客户已存在 audit 或 pass 状态记录，不允许再次提交。

ext 字段结构

ext 是一个 JSON 字符串，对应 OnlinePackageVO。

公共字段：

字段名	类型	说明
`packageName`	`String`	套餐名称
`packageId`	`Long`	套餐 ID
`businessType`	`String`	业务类型，`live` 或 `vod`
`amount`	`Long`	套餐金额
`businessStartTime`	`Date`	业务开始时间
`businessEndTime`	`Date`	业务结束时间
`billingPlanCode`	`String`	计费方式编码
`cooperationSubject`	`String`	合作主体

直播相关字段：

字段名	类型	说明
`livePackageMinutesQuantity`	`Long`	直播分钟数
`liveConcurrentQuantity`	`Long`	直播并发值
`liveConcurrentIsLimit`	`Short`	是否限制并发
`liveConcurrentDuration`	`Long`	直播并发购买时长
`liveConcurrentDurationUnit`	`String`	直播并发购买时长单位

点播相关字段：

字段名	类型	说明
`vodSpace`	`Long`	点播空间
`vodFlow`	`Long`	点播流量
`vodPackageType`	`String`	点播套餐类型编码
`vodPackageIsAnnualFlow`	`Short`	是否年流量套餐
`vodPackageFlowMonthsOfYear`	`Integer`	年流量月数

请求示例

{
  "customerId": "821775ea6c",
  "status": "audit",
  "ext": "{\"packageName\":\"直播定制套餐\",\"packageId\":1001,\"businessType\":\"live\",\"amount\":120000,\"businessStartTime\":\"2026-05-01 00:00:00\",\"businessEndTime\":\"2027-04-30 23:59:59\",\"billingPlanCode\":\"live_duration\",\"cooperationSubject\":\"0\",\"livePackageMinutesQuantity\":50000}"
}

返回结构

返回类型：ResponseVO<OnlineCustomPackageVO>

ResponseVO 字段

字段名	类型	说明
`code`	`Integer`	状态码，成功一般为 `200`
`status`	`String`	`success` / `error`
`requestId`	`String`	请求 ID
`error`	`Object`	失败信息
`data`	`OnlineCustomPackageVO`	返回数据

OnlineCustomPackageVO 字段

字段名	类型	说明
`id`	`Long`	主键
`customerId`	`String`	客户 ID
`status`	`String`	状态
`ext`	`String`	套餐详情 JSON 字符串
`createUserId`	`String`	创建人 ID
`createTime`	`Date`	创建时间
`updateTime`	`Date`	更新时间

成功返回示例

{
  "code": 200,
  "status": "success",
  "data": {
    "id": 12,
    "customerId": "821775ea6c",
    "status": "audit",
    "ext": "{\"packageName\":\"直播定制套餐\"}",
    "createUserId": "sale123",
    "createTime": "2026-04-29T16:00:00+08:00",
    "updateTime": "2026-04-29T16:00:00+08:00"
  }
}

失败返回示例

{
  "code": 400,
  "status": "error",
  "error": {
    "code": 400,
    "desc": "当前登录用户saleUserId为空，不允许提交"
  }
}

POLYV 帮助中心