用途:该技能为 Kinde 的计费能力建立一份计费契约,覆盖客户类型、环境、Stripe 模式、货币、计费管理员、套餐组与价格表、功能与费用、试用与税务、门户、权益、用量上报、Webhook、生命周期策略和控制面。它消费 kinde-b2b 的租户契约,不另建租户模型。
主要能力:建模组织型或用户型的套餐组、套餐、功能与价格;连接 Stripe 测试模式并发布定价;接入套餐选择、门户、权益校验、用量上报与 Webhook;提供 CONTRACT.md、PLANS.md、SETUP.md、RUNTIME.md、EVENTS.md、LIFECYCLE.md、REFERENCES.md 等分步阅读文件。
使用方式:先调用 kinde-b2b 获取租户契约,选择一个作业(model、setup、runtime、events、lifecycle/troubleshoot、go-live),再按对应分支步骤执行并做门禁验证。管理面接口包括查询权益 GET /api/v1/billing/entitlements?customer_id=、查询协议 GET /api/v1/billing/agreements?customer_id=、创建协议 POST /api/v1/billing/agreements、上报用量 POST /api/v1/billing/meter_usage 等。涉及角色或系统权限写入时调用 kinde-authorization,涉及创建者或成员分配时调用 kinde-organizations。
适用场景:需要为 SaaS 产品设计计费模型、配置测试环境、集成本地运行时权益与用量、处理事件与生命周期、或准备上线的团队。
限制:默认非生产 Kinde 环境与 Stripe 测试模式,生产 Stripe 连接、首次发布套餐、锁定货币、线上改价、取消或退款、计量写入等高影响操作必须获得明确授权。用户计费需先持久化并校验 (org_code, user_id) 到 customer_id 的映射,否则阻断写入。组织套餐与用户套餐不得混用同一套餐组或价格表。管理 MCP 不包含计费工具。DELETE 协议在文档与 OpenAPI 间存在冲突,资料建议记录该冲突且不要调用。框架实现依赖已加载的框架适配器,缺失时标记为阻断。