Stripe

核心用法

Stripe Skill 是 Maton 平台提供的托管式 Stripe API 网关服务，通过单一 Maton API Key 即可代理访问完整的 Stripe REST API。用户无需自行管理 Stripe 密钥和 OAuth 流程，所有认证凭证由 Maton 安全托管。

典型工作流：
1. 注册 Maton 账户获取 MATON_API_KEY
2. 在 ctrl.maton.ai 创建 Stripe 连接并完成 OAuth 授权
3. 通过 gateway.maton.ai/stripe/{native-api-path} 发起 API 请求
4. 使用 Maton-Connection 头部在多账户场景下指定连接

支持的 Stripe 核心实体： Customers（客户）、Products（产品）、Prices（定价）、Subscriptions（订阅）、Invoices（发票）、Payment Intents（支付意向）、Charges（扣款）、Balance（余额）、Events（事件）。所有列表接口支持分页，expand[] 参数可展开关联对象。

显著优点

• 零认证负担： 托管 OAuth 自动处理令牌刷新，开发者只需关注业务逻辑
• 统一凭证管理： 单一 MATON_API_KEY 管理多 Stripe 账户，降低密钥泄露风险
• 原生 API 兼容： 透传 Stripe API 路径和响应，学习成本低，可直接复用 Stripe 官方文档
• 多语言支持： 提供 Bash、Python、JavaScript 完整示例，快速上手

潜在缺点与局限性

• 平台依赖性： 完全依赖 Maton 网关可用性，若 Maton 服务中断则无法访问 Stripe
• 速率限制： 账户级 10 req/sec 的限制，高并发场景需自行实现队列
• 数据隐私： 支付数据流经 Maton 代理层，对数据主权敏感的企业需评估合规性
• 调试复杂度： 错误码分层（Maton 层 400/401/429 + Stripe 层 4xx/5xx），问题定位需区分责任边界

适合人群

• 初创团队/SaaS 开发者：快速集成订阅计费，无需自建支付基础设施
• 内部工具开发者：需自动化管理客户账单、生成发票的后台系统
• 多租户应用架构：通过 Connection ID 隔离不同商户的 Stripe 账户

常规风险

| 风险类型 | 说明 |

|---------|------|

| 密钥泄露 | `MATON_API_KEY` 具备全量 Stripe 访问权限，泄露可导致资金损失 |

| 权限过度 | 默认 OAuth 授权范围较宽，建议定期审计 `ctrl.maton.ai` 中的连接权限 |

| 合规风险 | 支付数据经第三方网关，需确认符合 PCI DSS 及属地数据法规 |

| 操作误删 | `DELETE /subscriptions/{id}` 直接取消订阅，无二次确认机制 |

安全建议： 使用环境变量注入密钥，避免硬编码；生产环境启用 Maton 的审计日志；定期轮换 API Key。