核心用法
Chargebee Skill 是 Maton 平台提供的托管式 OAuth 集成方案，允许用户通过统一的网关接口调用 Chargebee 原生 API。核心能力覆盖四大模块：
- 客户管理：创建、查询、更新客户档案，支持邮箱、姓名等字段筛选
- 订阅生命周期：创建订阅、查询详情、取消订阅（支持期末终止或立即生效）
- 发票与收款：列出发票、下载 PDF、处理收款状态
- 托管页面：生成结账页、创建客户自助门户会话
技术实现上，用户仅需持有 Maton API Key，所有请求经 gateway.maton.ai 代理至用户绑定的 Chargebee 子域名，自动完成 OAuth Token 注入与请求转发。
显著优点
1. 零凭证暴露：OAuth 授权由 Maton 托管，用户代码中无需存储 Chargebee 私有 API Key
2. 多租户支持：通过 Maton-Connection 头部可在单个 Maton 账户下管理多个 Chargebee 站点
3. 原生 API 透传：完全兼容 Chargebee 官方 API 路径与参数格式，学习成本极低
4. 连接生命周期管理：提供创建、查询、删除连接的独立端点，便于 CI/CD 场景自动化
潜在局限
- 网关依赖：所有流量必须经过 Maton 网关，存在单点可用性风险
- 速率限制：Maton 层限制 10 req/sec，高并发场景需本地队列缓冲
- 数据隐私：客户数据流经第三方网关，需评估合规敏感性
- 调试复杂度：错误可能源于 Maton 层（401/429）或 Chargebee 层（4xx/5xx），需分层排查
适合人群
- 需快速原型验证计费流程的 SaaS 初创团队
- 已在用 Maton 生态、希望统一凭证管理的开发者
- 多 Chargebee 站点运营的中型企业财务技术团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | MATON_API_KEY 若泄露，攻击者可访问所有绑定连接 |
| 误操作订阅 | 取消/修改订阅接口无二次确认，测试时建议用沙箱环境 |
| 数据残留 | 删除 Maton 连接不会清理 Chargebee 端数据，需额外审计 |