创建定价方案

post

https://{api}.subotiz.com/api/v1/prices

创建定价方案

Body Params

创建定价方案请求

name

string

required

定价方案名称

product_id

string

required

关联商品 ID

product_version_id

string

required

商品版本 ID

billing_type

string

required

计费类型：one_time-一次性 / recurring-周期性

price_val

string

一次性支付价格，当 billing_type 为 one_time 时必填

description

string

required

定价描述

has_trial

boolean

是否启用试用期

trial_period

object

TrialPeriod - 试用期配置

price_plan

object

创建定价时的定价计划

price_type

string

required

定价价格结构，取值之一：flat_price | package_price | tiers_price；based_on_usage 已废弃（存量只读），新建不可传

usage_amount

string

资源包用量（套餐含量），当 price_type 为 package_price 时必填

usage_unit

string

用量单位，当 price_type 为 package_price 时必填

features

array of objects

定价权益列表

features

model_type

string

定价模型二级类型（已废弃，逻辑并入 price_type + billing_dimension + quantity_tier_type/price_tier_type，新建不再使用）

billing_threshold

string

扣费金额阈值（已废弃，新建改用 usage_threshold；存量只读回显）

trial_type

int32

试用类型：0-免费试用 | 1-付费试用

trial_amount

string

试用价格，当 trial_type 为 1（付费试用）时必填

status

string

状态：

draft：草稿
active：已激活
frozen：已冻结

payment_timing

string

付费时机，取值之一：prepaid-预付费 / postpaid-后付费；默认 prepaid。
本期维度互斥：仅 (prepaid, quantity) 与 (postpaid, usage) 允许，其余组合拒绝

billing_dimension

string

计费维度，取值之一：quantity-按购买量(席位) / usage-按用量 / mixed-混合(预留，本期拒绝)；默认 quantity

usage_threshold

string

用量阈值（新口径，替代金额口径 billing_threshold）；后付费用量路线（billing_cycle_unit=over_threshold）时填写

quantity_unit

string

数量单位名称（商品级展示用，默认 unit）

Headers

Request-Id

string

required

Defaults to 008e3967-a1b5-48bb-be14-d5bff5092e61

请求的唯一标识符

Response

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK