stripe-automation

通过 Rube MCP 自动执行 Stripe 操作

通过 Rube MCP 使用 Composio 的 Stripe 工具包自动执行 Stripe 付款操作。

工具包文档：composio.dev/toolkits/stripe

前提条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Stripe 连接，工具包为 stripe
• 始终先调用 RUBE_SEARCH_TOOLS，以获取当前工具架构

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务。无需 API 密钥，只需添加端点即可使用。

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

注意事项：

• 金额以最小货币单位表示（USD 中 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: false

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

---

由 Composio 提供支持