API Reference
API Reference

业务对象

定价方案(Price)业务对象字段说明

属性名类型描述
idstring定价方案ID
price_namestring定价方案名称
price_aliasstring定价方案别名
product_idstring关联商品ID
merchant_idstring商户ID
currencystring币种
billing_typestring计费类型:one_time-一次性、recurring-周期性
price_valstring一次性付费价格,billing_type为one_time时必填
descriptionstring定价描述
price_planPricePlan定价计划
biz_statusstring状态:
  • draft: 草稿
  • active: 已激活
  • frozen: 已冻结
has_trialboolean是否启用试用期:
  • 0: 否
  • 1: 是
trial_periodTrialPeriod试用期配置
created_atstring创建时间
price_typestring定价模型
usage_amountstring资源包用量
usage_unitstring资源包用量单位
model_typestring定价模型二级类型
billing_thresholdstring扣费金额阈值
trial_typeint试用类型
  • 0: 免费试用
  • 1: 付费试用
trial_amountstring试用价格
metadatamap[string]string一组可附加到对象上的键值对,允许您以结构化格式存储附加信息。

PricePlan

属性名类型描述
idstring定价计划ID,系统生成的唯一标识
namestring计划名称,显示给用户的名称
billing_cycle_unitstring计费周期单位,如:day、week、month、year等
billing_cycle_countint计费周期数量,如:1个月、3个月等
is_infiniteboolean是否无限期,true表示永久有效
base_price_valstring基础价格,计划的基础定价
plan_descriptionstring计划描述,详细的计划说明信息
price_plan_tiersPriceTier[]分级定价明细,不同周期的具体价格

PriceTier

属性名类型描述
billing_cycle_indexint计费周期索引,表示第几个周期
price_valstring价格值,该周期的具体价格
discount_typestring优惠类型,如:percentage、fixed等
discount_valuestring优惠值,具体的优惠金额或比例

TrialPeriod

属性名类型描述
trial_period_unitstring试用期单位,必填,如:day、week、month等
trial_period_countint试用期数量,必填,如:7天、1个月等
These developer docs retire on 2026-08-30. Visit the new docs: NEW DOCS本开发者文档将于 2026-08-30下线,请访问新版文档: 新文档