用途:在 Stripe 上执行账单与支付运营操作,包括客户、产品、价格、发票、支付链接、订阅、退款和争议。MCP 为可选项,可通过 MCP(自动)、Stripe CLI 或 Dashboard 执行,具体见 BACKENDS.md。
主要能力与工作流:创建客户前先按邮箱搜索或列出以查重,再 create_customer(name, email, metadata),返回 cus_xxx;创建产品与价格时先列出产品查重,再 create_product 与 create_price(product=prod_xxx, unit_amount=cents, currency),返回 prod_xxx 与 price_xxx;创建并发送发票依次为确认客户 ID、create_invoice、create_invoice_item、finalize_invoice,返回 inv_xxx 与 hosted_invoice_url;创建支付链接先确认价格 ID,再 create_payment_link(line_items=[{price, quantity}]),返回链接 URL。
安全规则:读操作(list、get、search)可直接执行;创建类操作先查重;涉及资金的操作(退款、订阅取消/更新、争议)须先展示对象 ID 与关键字段、说明金额与影响,等待明确确认后再执行,并返回结果、对象 ID 与状态。默认测试模式,使用实时模式需明确说明并二次确认。金额接受小数并自动转换为最小单位(如 $19.99 → 1999);币种优先用户指定,其次沿用对象币种,否则询问。
限制:标准工具不支持直接创建 PaymentIntent/扣款、创建订阅(仅可列出/更新/取消)、创建促销码(仅优惠券)以及删除对象,这些需使用 Dashboard 或 API。错误处理包括搜索正确 ID、检查参数格式、API 密钥权限与网络重试。多步骤流程可采用基于文件的管道,在 runs/<workflow>/active/<run_id>/ 下记录 proposal.md、context.json、tasks.md、evidence 与日志。