用途：围绕 Chargebee 订阅计费与收入管理平台提供操作指导，帮助完成 API 集成、Webhook 消费、产品目录迁移、催收配置与按比例计费等任务。Chargebee 构建在自有支付网关之上，用户仍是记录卖方（seller of record），并非 Merchant of Record。
主要能力：创建客户与订阅、管理发票、拉取数据；配置并消费 Webhook 以开通或撤销访问权限、驱动催收；Product Catalog 1.0（plans/addons）迁移到 2.0（items/item-prices）；配置催收与智能重试；理解周期中升降级的按比例计费；配置面向 Claude 或 Cursor 的 Chargebee MCP 服务器与 AgentKit。选型类问题（如与 Recurly、Maxio、Stripe Billing 对比）会路由到 /sales-subscription-billing，MoR 与税务问题路由到 /sales-merchant-of-record。
使用方式：API 基址为 https://{site}.chargebee.com/api/v2/，采用 HTTP Basic 认证，API key 作为用户名、密码留空，例如 curl https://{site}.chargebee.com/api/v2/customers -u {api_key}:。请求为表单编码，响应为 JSON 信封，分页用 offset/limit。写入操作应携带 chargebee-idempotency-key（UUID，30 分钟窗口）避免重复扣费。Webhook 无 HMAC 签名，需用 basic auth 或 URL 密钥保护并限制来源 IP，按 event id 去重、按 resource_version 排序。
限制：Webhook 异步、无序且约 2–3 天内重投，不适合时间敏感流程；PC 1.0 与 2.0 的 API 端点不同且迁移单向不可回滚；金额以最小货币单位表示（4900 即 49.00）；免费 Starter 额度为累计而非每月。资料未提供具体价格与平台支持细节。