stripe-automation

通过 Rube MCP 自动化 Stripe

通过 Rube MCP 使用 Composio 的 Stripe 工具包自动化 Stripe 支付操作。

前提条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 激活 Stripe 连接，并使用工具包 stripe
• 始终先调用 RUBE_SEARCH_TOOLS，以获取当前工具架构

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。MCP 端点仍需要已安装的 Rube 服务返回的提供商连接和授权流程；仅添加 URL 并不会授予账户访问权限。

1. 确认 RUBE_SEARCH_TOOLS 能正常响应，以验证 Rube MCP 是否可用
2. 使用工具包 stripe 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，请按照返回的授权链接完成 Stripe 连接
4. 确认连接状态显示为 ACTIVE 后，再运行任何工作流

核心工作流

1. 管理客户

适用场景：用户想要创建、更新、搜索或列出 Stripe 客户

工具调用顺序：

1. STRIPE_SEARCH_CUSTOMERS - 按电子邮件或姓名搜索客户 [可选]
2. STRIPE_LIST_CUSTOMERS - 列出所有客户 [可选]
3. STRIPE_CREATE_CUSTOMER - 创建新客户 [可选]
4. STRIPE_POST_CUSTOMERS_CUSTOMER - 更新客户 [可选]

关键参数：

• email：客户的电子邮件
• name：客户姓名
• description：客户描述
• metadata：键值对元数据
• customer：用于更新的客户 ID（例如，'cus_xxx'）

注意事项：

• Stripe 允许多个客户使用相同的电子邮件；请先搜索以避免重复
• 客户 ID 以 'cus_' 开头

2. 管理收费和付款

适用场景：用户想要创建收费、付款意向或查看收费历史记录

工具调用顺序：

1. STRIPE_LIST_CHARGES - 使用筛选条件列出收费 [可选]
2. STRIPE_CREATE_PAYMENT_INTENT - 创建付款意向 [可选]
3. STRIPE_CONFIRM_PAYMENT_INTENT - 确认付款意向 [可选]
4. STRIPE_POST_CHARGES - 创建直接收费 [可选]
5. STRIPE_CAPTURE_CHARGE - 扣取已授权的款项 [可选]

关键参数：

• amount：以最小货币单位表示的金额（例如，美元的美分）
• currency：三字母 ISO 货币代码（例如，'usd'）
• customer：客户 ID
• payment_method：付款方式 ID
• description：收费说明

注意事项：

• 金额以最小货币单位表示（美元中 100 = $1.00）
• 货币代码必须使用小写字母（例如，'usd'，而不是 'USD'）
• 建议使用付款意向流程，而不是直接收费

3. 管理订阅

适用场景：用户想要创建、列出、更新或取消订阅

工具调用顺序：

1. STRIPE_LIST_SUBSCRIPTIONS - 列出订阅 [可选]
2. STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS - 创建订阅 [可选]
3. STRIPE_RETRIEVE_SUBSCRIPTION - 获取订阅详情 [可选]
4. STRIPE_UPDATE_SUBSCRIPTION - 修改订阅 [可选]

关键参数：

• customer：客户 ID
• items：价格项目数组（price_id 和 quantity）
• subscription：用于检索或更新的订阅 ID（例如，'sub_xxx'）

注意事项：

• 订阅需要有效客户及其付款方式
• 订阅项目使用价格 ID（而不是产品 ID）
• 可以立即取消，也可以在当前周期结束时取消

4. 管理发票

使用场景：用户想要创建、列出或搜索发票

工具调用顺序：

1. STRIPE_LIST_INVOICES - 列出发票 [可选]
2. STRIPE_SEARCH_INVOICES - 搜索发票 [可选]
3. STRIPE_CREATE_INVOICE - 创建发票 [可选]

关键参数：

• customer：发票对应的客户 ID
• collection_method：'charge_automatically' 或 'send_invoice'
• days_until_due：发票到期前的天数

注意事项：

• 根据预期的发票工作流明确设置 auto_advance；不要假设工具/API 的默认值。准备草稿并不代表已获准完成发票、付款或发送电子邮件。

5. 管理产品和价格

使用场景：用户想要列出或搜索产品及其价格

工具调用顺序：

1. STRIPE_LIST_PRODUCTS - 列出产品 [可选]
2. STRIPE_SEARCH_PRODUCTS - 搜索产品 [可选]
3. STRIPE_LIST_PRICES - 列出价格 [可选]
4. STRIPE_GET_PRICES_SEARCH - 搜索价格 [可选]

关键参数：

• active：按启用/停用状态筛选
• query：搜索端点的搜索查询

注意事项：

• 产品和价格是不同的对象；一个产品可以有多个价格
• 价格 ID（例如 'price_xxx'）用于订阅和结账

6. 处理退款

使用场景：用户想要为收费发起退款

工具调用顺序：

1. STRIPE_LIST_REFUNDS - 列出退款 [可选]
2. STRIPE_POST_CHARGES_CHARGE_REFUNDS - 创建退款 [可选]
3. STRIPE_CREATE_REFUND - 通过付款意图创建退款 [可选]

关键参数：

• charge：退款对应的收费 ID
• amount：部分退款金额（全额退款时省略）
• reason：退款原因（'duplicate'、'fraudulent'、'requested_by_customer'）

注意事项：

• 退款可能需要 5–10 个工作日才会显示在客户账单上
• 金额以货币最小单位表示

常见模式

金额格式

Stripe 使用货币最小单位：

• USD：$10.50 = 1050 美分
• EUR：10.50 = 1050 美分
• JPY：1000 = 1000（无小数）

分页

• 使用 limit 参数（最大值为 100）
• 检查响应中的 has_more
• 将最后一个对象 ID 作为 starting_after 传入，以获取下一页
• 继续操作，直到 has_more 为 false

已知注意事项

金额单位：

• 始终使用货币最小单位（USD/EUR 使用美分）
• 零小数位货币（JPY、KRW）直接使用金额

ID 前缀：

• 客户：cus_，收费：ch_，订阅：sub_
• 发票：in_，产品：prod_，价格：price_
• 付款意图：pi_，退款：re_

快速参考

任务	工具标识	关键参数
创建客户	STRIPE_CREATE_CUSTOMER	email, name
搜索客户	STRIPE_SEARCH_CUSTOMERS	query
更新客户	STRIPE_POST_CUSTOMERS_CUSTOMER	customer, fields
列出收费	STRIPE_LIST_CHARGES	customer, limit
创建付款意图	STRIPE_CREATE_PAYMENT_INTENT	amount, currency
确认付款	STRIPE_CONFIRM_PAYMENT_INTENT	payment_intent
列出订阅	STRIPE_LIST_SUBSCRIPTIONS	customer
创建订阅	STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS	customer, items
更新订阅	STRIPE_UPDATE_SUBSCRIPTION	subscription, fields
列出发票	STRIPE_LIST_INVOICES	customer
创建发票	STRIPE_CREATE_INVOICE	customer
搜索发票	STRIPE_SEARCH_INVOICES	query
列出产品	STRIPE_LIST_PRODUCTS	active
搜索产品	STRIPE_SEARCH_PRODUCTS	query
列出价格	STRIPE_LIST_PRICES	product
搜索价格	STRIPE_GET_PRICES_SEARCH	query
列出退款	STRIPE_LIST_REFUNDS	charge
创建退款	STRIPE_CREATE_REFUND	charge, amount
付款方式	STRIPE_LIST_CUSTOMER_PAYMENT_METHODS	customer
结账会话	STRIPE_CREATE_CHECKOUT_SESSION	line_items
列出付款意图	STRIPE_LIST_PAYMENT_INTENTS	customer

适用场景

当需要执行概览中描述的工作流或操作时，可使用此技能。

示例

用户请求：

通过 Rube MCP（Composio）自动执行 Stripe 任务：客户、扣款、订阅、发票、产品、退款。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停止并请求澄清。

确认准确的关联账户、测试／正式模式、以货币特定最小单位表示的金额、币种、客户以及预期的财务影响。搜索结果匹配不代表已获得授权，也不能避免竞态。写入操作应使用服务提供方支持的幂等键；重试时保留该键，并在再次发起扣款／退款／订阅变更前核实结果不明的操作。切勿记录完整的付款／客户数据，也不要根据工具调用推断结算状态。