Stripe

• 您希望 AI 代理能够创建或管理 Stripe 客户、产品和定价，而无需在环境中直接嵌入 Stripe 密钥。
• 您需要在代理工作流中自动化订阅生命周期操作——创建订阅、更新计划或取消订阅。
• 您希望使用 Python 或 JavaScript 以编程方式查询付款历史记录、检索发票 PDF 或发起退款。
• 您管理多个 Stripe 账户，需要使用 Maton-Connection 请求头将请求路由到特定连接。

• 您需要与 Stripe 以外的第三方服务集成 — 请改用 api-gateway skill。
• 您需要直接处理 Stripe webhook 或实时事件流，而此 REST 代理不提供该功能。
• 您没有有效的 Maton API 密钥，或无法从您的网络访问 gateway.maton.ai。

身份验证完全通过您的 MATON_API_KEY 处理。Maton 网关将您的请求代理至 api.stripe.com，并自动注入正确的 Stripe OAuth 令牌，从而无需自行存储或轮换 Stripe 凭据。

支持对客户、产品、价格、订阅、发票、收费、支付意图、支付方式、优惠券和退款执行 CRUD 操作，全面覆盖 Stripe 核心账单与支付功能。

在 ctrl.maton.ai 的 Maton 控制面板中管理多个 Stripe OAuth 连接。进行 API 调用时，可使用 Maton-Connection 请求头指定特定的 Stripe 账户，或让网关默认使用您最早的活跃连接。

所有列表端点均通过 starting_after 和 ending_before 查询参数支持 Stripe 的原生基于游标的分页，响应中包含 has_more 字段，以简化对大型数据集的迭代操作。

超越基本的增删改查操作——使用专用的动作端点（/finalize、/pay、/void）来完成草稿发票的定稿、触发付款收取或作废发票。托管发票 URL 和 PDF 链接将在响应中返回。

通过代理工作流创建客户、绑定支付方式并订阅周期性价格方案。使用订阅 API 按需升级或降级套餐，并在需要时取消订阅。

查询余额交易记录、按客户或日期筛选列出收费信息，并检索支付意向状态，以便以编程方式生成财务摘要或对账支付记录。

在用户注册时自动创建 Stripe 客户记录，附加内部用户 ID 等元数据，并在更广泛的引导自动化流程中查询或更新客户详细信息。

通过 API 创建百分比折扣或固定金额折扣优惠券用于促销活动、列出现有优惠券并删除已过期的优惠券——无需登录 Stripe Dashboard，一切操作均可完成。