SuperAPI AI 工具集

stripe-automation

办公与效率

查看项目

更新于 10-15 08:04

技能介绍

Stripe Automation 通过 Composio 的 Stripe 工具包,经由 Rube MCP 自动化 Stripe 支付相关操作。

用途 该工具用于在 MCP 客户端中自动执行 Stripe 的日常支付管理任务,包括客户管理、收款与支付、订阅、发票、产品与价格、退款等。

前置条件

  • 必须已连接 Rube MCP(RUBE_SEARCH_TOOLS 可用)。
  • 通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit stripe 建立有效的 Stripe 连接。
  • 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

设置方式

  1. 获取 Rube MCP:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥,添加端点即可使用。
  2. 确认 RUBE_SEARCH_TOOLS 有响应,以验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS,toolkit 为 stripe。
  4. 若连接不是 ACTIVE,按返回的授权链接完成 Stripe 连接。
  5. 确认连接状态为 ACTIVE 后再运行任何工作流。

核心工作流

  1. 管理客户:搜索、列出、创建、更新客户。常用工具包括 STRIPE_SEARCH_CUSTOMERS、STRIPE_LIST_CUSTOMERS、STRIPE_CREATE_CUSTOMER、STRIPE_POST_CUSTOMERS_CUSTOMER。关键参数有 email、name、description、metadata、customer。注意 Stripe 允许相同邮箱的重复客户,建议先搜索以避免重复;客户 ID 以 cus_ 开头。
  2. 管理收款与支付:列出收款、创建并确认支付意图、创建直接收款、捕获已授权收款。常用工具包括 STRIPE_LIST_CHARGES、STRIPE_CREATE_PAYMENT_INTENT、STRIPE_CONFIRM_PAYMENT_INTENT、STRIPE_POST_CHARGES、STRIPE_CAPTURE_CHARGE。关键参数有 amount、currency、customer、payment_method、description。注意金额使用最小货币单位(USD 中 100 = $1.00),货币代码必须小写,推荐使用支付意图而非直接收款。
  3. 管理订阅:列出、创建、检索、更新订阅。常用工具包括 STRIPE_LIST_SUBSCRIPTIONS、STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS、STRIPE_RETRIEVE_SUBSCRIPTION、STRIPE_UPDATE_SUBSCRIPTION。关键参数有 customer、items(price_id 与 quantity)、subscription。注意订阅需要有效客户及支付方式,订阅项使用价格 ID 而非产品 ID,取消可立即或在周期结束时生效。
  4. 管理发票:列出、搜索、创建发票。常用工具包括 STRIPE_LIST_INVOICES、STRIPE_SEARCH_INVOICES、STRIPE_CREATE_INVOICE。关键参数有 customer、collection_method、days_until_due。注意发票默认自动最终化,如需草稿可设置 auto_advance: false。
  5. 管理产品与价格:列出或搜索产品与价格。常用工具包括 STRIPE_LIST_PRODUCTS、STRIPE_SEARCH_PRODUCTS、STRIPE_LIST_PRICES、STRIPE_GET_PRICES_SEARCH。关键参数有 active、query。注意产品与价格是独立对象,一个产品可有多个价格;订阅和结账使用价格 ID(如 price_xxx)。
  6. 处理退款:列出退款、创建退款。常用工具包括 STRIPE_LIST_REFUNDS、STRIPE_POST_CHARGES_CHARGE_REFUNDS、STRIPE_CREATE_REFUND。关键参数有 charge、amount、reason。注意退款可能需要 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

适用场景 适用于需要在 MCP 客户端中自动化 Stripe 支付管理流程的用户,例如批量管理客户、处理订阅与发票、查询产品价格、发起退款等。

限制 使用前必须完成 Rube MCP 与 Stripe 连接;所有操作依赖 RUBE_SEARCH_TOOLS 返回的最新 schema;金额、货币、ID 前缀等需遵循 Stripe 规范。其他未在资料中说明的功能、收费、价格、平台或效果暂未提供。