Feature 检查与 Paywall

当前功能定义、访问检查、购买建议与付款后重新验证。

API v1更新于 2026年10月16日

开始前准备

已有可信 Customer 和 Feature 需求。读取与检查用于展示；执行业务前的扣量必须留在可信后端。

readHoldings 展示当前 Customer 的持有与余额。checkEntitlement 在部署支持时返回明确的访问结果；配置 requirement 时使用当前契约字段。界面可见、Feature Flag 为 true、显示 Paywall 或购买完成都不替代后端实际授权。

执行受保护任务前由可信后端 mutateBalance 消费或 reserve；异步任务完成后确认实际数量，失败释放。访问求值未配置时显示明确错误，不自行推定允许。

访问不满足且可以通过购买解决时，引导到已发布的独立 Paywall。购买后重新读取真实权益，再继续原业务。

可以在已完成的 HTTP 接入上调用这些操作。每页参考列出完整请求、响应和凭据要求；有匹配 SDK 时，也可使用本页 SDK 示例。

操作与权限
操作	HTTP	权限
checkEntitlement	POST /api/v1/entitlements/check	entitlements:read
mutateBalance	POST /api/v1/balances/execute	credits:consume

操作与权限

预期结果

可用时继续业务；可通过购买满足时展示 Paywall；限额、认证或配置问题显示具体原因。