保利威文档中心

帮助中心

POLYV 帮助中心

pop-parent 接口文档

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

查询套餐续费信息

接口地址

GET /pcs/v1/customer/package-renewal/info

接口说明

查询客户的套餐续费信息、资源包续费信息、资源包列表。

请求参数

参数名 类型 必填 说明
liveUserId String 是 直播用户 ID

说明：

  • 当前实现中，该接口实际主要使用 liveUserId。
  • 非普通账号会直接返回空对象。

返回结果

返回对象：PackageRenewalInfoVO

字段名 类型 说明
packageRenewalStatus PackageRenewalStatusVO 套餐续费状态
resourcePackageStatus PackageRenewalStatusVO 资源包续费状态
resourcePackageList List<ResourcePackagesDetailVO> 资源包列表

packageRenewalStatus / resourcePackageStatus 字段

字段名 类型 说明
renewalInfo PackageRenewalBasicInfo 基础续费状态
livePackageInfo LivePackageInfo 当前直播套餐信息
vodPackageInfo VodPackageInfo 当前点播套餐信息
accountBalanceInfo AccountBalanceInfo 账户余额信息
vodAgreementType String 点播协议类型
liveAgreementType String 直播协议类型
resourceAgreementType String 资源包协议类型
livePackageInfoList List<LivePackageInfo> 直播套餐列表
vodPackageInfoList List<VodPackageInfo> 点播套餐列表

renewalInfo 字段

字段名 类型 说明
liveWaitOpenExists String 直播是否存在待开通资源，Y/N
vodWaitOpenExists String 点播是否存在待开通资源，Y/N
liveRenewalEnabled String 直播是否可续费，Y/N
vodRenewalEnabled String 点播是否可续费，Y/N
disabledByAccount String 是否因账户校验不可续费，Y/N

LivePackageInfo 字段

字段名 类型 说明
packageId Long 套餐 ID
billingPlanCode String 套餐编码，如 live_duration、live_concurrent
currentStartDate String 当前套餐开始时间
currentEndDate String 当前套餐结束时间
remainingDays Integer 剩余天数
renewalStartDate String 新套餐开始时间
renewalEndDate String 新套餐结束时间
validityUnit Integer 有效月数
amount Long 金额
packageName String 套餐名称
packageDesc String 套餐描述
productCode String 产品编码
cooperationSubject String 签约主体，0/1/2/3
origin String 来源
createUserName String 创建人名称
approvalStatus String 审批状态，如 audit/pass/reject
validLiveDuration Long 当前可用直播分钟数
liveDuration Long 套餐直播分钟数
liveConcurrences Long 套餐并发数
liveConcurrentIsLimit Short 是否限制并发，0/1

VodPackageInfo 字段

字段名 类型 说明
packageId Long 套餐 ID
billingPlanCode String 套餐编码
currentStartDate String 当前套餐开始时间
currentEndDate String 当前套餐结束时间
remainingDays Integer 剩余天数
renewalStartDate String 新套餐开始时间
renewalEndDate String 新套餐结束时间
validityUnit Integer 有效月数
amount Long 金额
packageName String 套餐名称
packageDesc String 套餐描述
productCode String 产品编码
cooperationSubject String 签约主体
origin String 来源
createUserName String 创建人名称
approvalStatus String 审批状态
vodFlow Long 点播流量
vodSpace Long 点播空间
vodPackageIsAnnualFlow Short 是否年流量套餐
packageIsCustomize Short 是否定制套餐
vodPackageFlowMonthsOfYear Integer 年流量月数

AccountBalanceInfo 字段

字段名 类型 说明
liveUserStatus String 直播用户状态
validAmount Long 账户余额

resourcePackageList 字段

字段名 类型 说明
id Integer 主键
categoryDisplay String 分类显示名称
pricingTypeDisplay String 使用时效规则
name String 资源包名称
description String 资源包描述
category String 资源包分类
crmProductId String CRM 产品 ID
crmProductName String CRM 产品名称
unitPrice String 单价
billingUnit String 计费单位
minPurchaseQty Integer 最小购买数量
maxPurchaseQty Integer 最大购买数量
pricingType String 计费模式
durationDays Integer 持续天数
presetQuantities List<Integer> 预设数量
dependencyType List<String> 依赖类型
sortOrder Integer 排序
purchasable String 是否可购买，Y/N
cooperationSubject String 支付主体
merchantCode String 商户编码
validityUnit Integer 有效期值
validity Integer 有效期单位
startDate String 新套餐开始时间
endDate String 新套餐截止时间
convertPrice BigDecimal 换算单价
purchaseStep Integer 购买步长
tags List<TagVO> 标签列表

请求示例

GET /pcs/v1/customer/package-renewal/info?liveUserId=9a8b7c6d5e

返回示例

{
  "packageRenewalStatus": {
    "renewalInfo": {
      "liveWaitOpenExists": "N",
      "vodWaitOpenExists": "N",
      "liveRenewalEnabled": "Y",
      "vodRenewalEnabled": "Y",
      "disabledByAccount": "N"
    },
    "livePackageInfo": {
      "packageId": 1001,
      "billingPlanCode": "live_duration",
      "packageName": "直播分钟数套餐",
      "amount": 120000
    },
    "vodPackageInfo": {
      "packageId": 2001,
      "billingPlanCode": "vod_package",
      "packageName": "点播套餐",
      "amount": 80000
    }
  },
  "resourcePackageStatus": {
    "renewalInfo": {
      "liveRenewalEnabled": "Y",
      "vodRenewalEnabled": "Y"
    }
  },
  "resourcePackageList": [
    {
      "id": 1,
      "name": "直播流量包",
      "category": "live_flow",
      "unitPrice": "1000"
    }
  ]
}
联系客服，在线咨询