商品与权益
当前功能定义、内部计价快照与会员/充值的固定合同。
SDK 0.0.1更新于
商品版本与权益
Products & Billing 管理会员商品和一次性充值,发布版本不可变。权益分为 access、metered、credit;保存功能更新当前配置,归档/恢复控制可用性;内部快照保留计价证据。商品引用固定快照,已有客户保留原合同。默认积分费率用于后续新消费,显式套餐费率与已冻结操作保留原价格。默认免费套餐须按组配置有效版本,自动试用另有资格和政策;未配置时不自动授予。
浏览器通过 readHoldings 读取当前会员和精确余额,通过 quoteBalance 报价;消费与预扣由可信后端 mutateBalance 原子执行。主套餐同组互斥,附加套餐独立。
功能保存与商品发布
功能(底层 Entitlement)定义 access、metered 或 credit。当前源码保存 configuration 即更新定义,用 active/archived 及恢复管理可用性,不执行独立功能 publish。商品仍保存草稿并发布不可变版本,固定价格、试用、授予和专属费率。已有商品合同不会自动采用新商品版本;功能的内部快照用于计价证据,不是开发者要发布的独立资源。
默认 Credit 费率从每次 2 改成 3 后,新消费和新预扣采用 3;此前冻结为 2 的预扣、确认和退款保留原价。套餐明确覆盖为 5 时继续使用 5。应用缓存 AI 配置时,保存新配置后重新读取 pricing,已有 quote 不重新计价。此服务端增量须匹配数据库迁移及部署,不能由 npm 安装版本推定已经上线。
集成中的 ID 含义| 字段 | 指向什么 |
|---|
| entitlementId | 功能的稳定身份,用于持有、检查及用量操作 |
| entitlementVersionId | 内部不可变证据快照,用于商品授予或费率引用 |
| productVersionId | 已发布商品合同,报价与购买固定该版本 |
| couponId | 优惠券条款定义;不是客户已持有的券 |
| offerId | 客户实际持券记录;previewAttach 选券传此 ID |
集成中的 ID 含义
entitlementId
- 指向什么
- 功能的稳定身份,用于持有、检查及用量操作
entitlementVersionId
- 指向什么
- 内部不可变证据快照,用于商品授予或费率引用
productVersionId
- 指向什么
- 已发布商品合同,报价与购买固定该版本
couponId
- 指向什么
- 优惠券条款定义;不是客户已持有的券
offerId
- 指向什么
- 客户实际持券记录;previewAttach 选券传此 ID
商业功能与决策 Feature
两者用途不同:商业 Feature 定义客户可以使用什么及怎样计量,实际权限由客户合同、容量、余额和用量决定。GrowthBook Feature 通过 createFeatureClient 计算任意 JSON 值,供实验和路由使用。实验返回 true 不代表客户已购买,也不能授权扣款。
查看访问状态使用当前客户 readHoldings 或匹配新源码的 checkEntitlement;执行受保护任务仍由可信后端使用 mutateBalance 消费/预扣,非消耗型能力读取真实占用和容量。界面条件、Feature 值和付款回跳都不能代替后端授权。