> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subotiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 业务对象

定价方案（Price）业务对象字段说明

| 属性名 | 类型 | 描述 |
| - | - | - |
| id | string | 定价方案ID |
| price\_name | string | 定价方案名称 |
| price\_alias | string | 定价方案别名 |
| product\_id | string | 关联商品ID |
| merchant\_id | string | 商户ID |
| currency | string | 币种 |
| billing\_type | string | 计费类型：one\_time-一次性、recurring-周期性 |
| price\_val | string | 一次性付费价格，billing\_type为one\_time时必填 |
| description | string | 定价描述 |
| price\_plan | PricePlan | 定价计划 |
| biz\_status | string | 状态：<br />draft: 草稿<br />active: 已激活<br />frozen: 已冻结 |
| has\_trial | boolean | 是否启用试用期：<br />0: 否<br />1: 是 |
| trial\_period | TrialPeriod | 试用期配置 |
| created\_at | string | 创建时间 |
| price\_type | string | 定价模型 |
| usage\_amount | string | 资源包用量 |
| usage\_unit | string | 资源包用量单位 |
| model\_type | string | 定价模型二级类型 |
| billing\_threshold | string | 扣费金额阈值 |
| trial\_type | int | 试用类型<br />0: 免费试用<br />1: 付费试用 |
| trial\_amount | string | 试用价格 |
| metadata | map\[string]string | 一组可附加到对象上的键值对，允许您以结构化格式存储附加信息。 |

## PricePlan

| 属性名 | 类型 | 描述 |
| - | - | - |
| id | string | 定价计划ID，系统生成的唯一标识 |
| name | string | 计划名称，显示给用户的名称 |
| billing\_cycle\_unit | string | 计费周期单位，如：day、week、month、year等 |
| billing\_cycle\_count | int | 计费周期数量，如：1个月、3个月等 |
| is\_infinite | boolean | 是否无限期，true表示永久有效 |
| base\_price\_val | string | 基础价格，计划的基础定价 |
| plan\_description | string | 计划描述，详细的计划说明信息 |
| price\_plan\_tiers | PriceTier\[] | 分级定价明细，不同周期的具体价格 |

## PriceTier

| 属性名 | 类型 | 描述 |
| - | - | - |
| billing\_cycle\_index | int | 计费周期索引，表示第几个周期 |
| price\_val | string | 价格值，该周期的具体价格 |
| discount\_type | string | 优惠类型，如：percentage、fixed等 |
| discount\_value | string | 优惠值，具体的优惠金额或比例 |

## TrialPeriod

| 属性名 | 类型 | 描述 |
| - | - | - |
| trial\_period\_unit | string | 试用期单位，必填，如：day、week、month等 |
| trial\_period\_count | int | 试用期数量，必填，如：7天、1个月等 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.