Sim

Stripe

处理支付并管理 Stripe 数据

Stripe 是一个强大的支付平台,可以让您轻松管理支付、客户、订阅、发票、产品等。

将 Stripe 集成到 Sim 中后,您的代理可以:

  • 创建和管理支付意图:通过灵活的配置选项处理支付。
  • 管理客户:创建、检索和更新您的业务客户记录。
  • 处理订阅:管理循环计费和订阅生命周期。
  • 创建和发送发票:为一次性或循环支付生成发票。
  • 跟踪和管理收费:检索和更新收费对象以监控支付。
  • 配置产品和价格:设置您的产品目录、定价模型和优惠。
  • 监听和响应 Stripe 事件:在支付更新、成功收费和其他 Stripe 事件发生时触发工作流。

通过将 Sim 与 Stripe 连接,您可以在代理工作流中实现无缝的自动化和财务操作。自动化客户入驻、订阅管理、支付收款、发票生成,甚至在支付事件发生时执行自定义操作——所有这些都由您的代理通过 Stripe 安全地直接处理。

无论您是在构建电子商务自动化、订阅服务,还是运行报告和对账,Stripe 工具都能让您轻松地在智能 Sim 工作流中协调支付和财务数据。

使用说明

将 Stripe 集成到工作流中。管理支付意图、客户、订阅、发票、收费、产品、价格和事件。可以在触发模式下使用,当发生 Stripe 事件时触发工作流。

工具

stripe_create_payment_intent

创建一个新的支付意图以处理支付

输入

参数类型必需描述
apiKeystringStripe API 密钥 (secret key)
amountnumber金额(以分为单位)(例如,2000 表示 $20.00)
currencystring三字母 ISO 货币代码 (例如,usd, eur)
customerstring与此支付关联的客户 ID
payment_methodstring支付方式 ID
descriptionstring支付描述
receipt_emailstring用于发送收据的电子邮件地址
metadatajson用于存储附加信息的键值对集合
automatic_payment_methodsjson启用自动支付方式 (例如,{"enabled": true})

输出

参数类型描述
payment_intentjson创建的 Payment Intent 对象
metadatajson包含 ID、状态、金额和货币的 Payment Intent 元数据

stripe_retrieve_payment_intent

通过 ID 检索现有的 Payment Intent

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstringPayment Intent ID(例如,pi_1234567890)

输出

参数类型描述
payment_intentjson检索到的 Payment Intent 对象
metadatajson包含 ID、状态、金额和货币的 Payment Intent 元数据

stripe_update_payment_intent

更新现有的 Payment Intent

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstringPayment Intent ID(例如,pi_1234567890)
amountnumber更新后的金额(以分为单位)
currencystring三字母 ISO 货币代码
customerstring客户 ID
descriptionstring更新后的描述
metadatajson更新后的元数据

输出

参数类型描述
payment_intentjson更新后的 Payment Intent 对象
metadatajson包含 ID、状态、金额和货币的 Payment Intent 元数据

stripe_confirm_payment_intent

确认 Payment Intent 以完成支付

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstringPayment Intent ID(例如,pi_1234567890)
payment_methodstring用于确认的支付方式 ID

输出

参数类型描述
payment_intentjson确认的 Payment Intent 对象
metadatajson包括 ID、状态、金额和货币的 Payment Intent 元数据

stripe_capture_payment_intent

捕获已授权的 Payment Intent

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstringPayment Intent ID(例如,pi_1234567890)
amount_to_capturenumber捕获的金额(以分为单位,默认为全额)

输出

参数类型描述
payment_intentjson捕获的 Payment Intent 对象
metadatajson包括 ID、状态、金额和货币的 Payment Intent 元数据

stripe_cancel_payment_intent

取消 Payment Intent

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstringPayment Intent ID(例如,pi_1234567890)
cancellation_reasonstring取消原因(duplicate, fraudulent, requested_by_customer, abandoned)

输出

参数类型描述
payment_intentjson已取消的 Payment Intent 对象
metadatajson包含 ID、状态、金额和货币的 Payment Intent 元数据

stripe_list_payment_intents

列出所有 Payment Intent

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
limitnumber返回结果的数量(默认 10,最大 100)
customerstring按客户 ID 过滤
createdjson按创建日期过滤(例如,{"gt": 1633024800})

输出

参数类型描述
payment_intentsjsonPayment Intent 对象的数组
metadatajson列表元数据,包括计数和 has_more

stripe_search_payment_intents

使用查询语法搜索 Payment Intent

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
querystring搜索查询(例如,"status:'succeeded' AND currency:'usd'")
limitnumber返回结果的数量(默认 10,最大 100)

输出

参数类型描述
payment_intentsjson匹配的 Payment Intent 对象的数组
metadatajson搜索元数据,包括计数和 has_more

stripe_create_customer

创建一个新的客户对象

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
emailstring客户的电子邮件地址
namestring客户的全名
phonestring客户的电话号码
descriptionstring客户的描述
addressjson客户地址对象
metadatajson键值对集合
payment_methodstring要附加的支付方式 ID

输出

参数类型描述
customerjson创建的客户对象
metadatajson客户元数据

stripe_retrieve_customer

通过 ID 检索现有客户

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring客户 ID(例如,cus_1234567890)

输出

参数类型描述
customerjson检索到的客户对象
metadatajson客户元数据

stripe_update_customer

更新现有客户

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring客户 ID(例如,cus_1234567890)
emailstring更新后的电子邮件地址
namestring更新后的姓名
phonestring更新后的电话号码
descriptionstring更新后的描述
addressjson更新后的地址对象
metadatajson更新后的元数据

输出

参数类型描述
customerjson更新的客户对象
metadatajson客户元数据

stripe_delete_customer

永久删除客户

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring客户 ID(例如,cus_1234567890)

输出

参数类型描述
deletedboolean客户是否已删除
idstring已删除客户的 ID
metadatajson删除元数据

stripe_list_customers

列出所有客户

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
limitnumber返回结果的数量(默认 10,最大 100)
emailstring按电子邮件地址筛选
createdjson按创建日期筛选

输出

参数类型描述
customersjson客户对象数组
metadatajson列表元数据

stripe_search_customers

使用查询语法搜索客户

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
querystring搜索查询(例如,"email:'customer@example.com'")
limitnumber返回结果的数量(默认 10,最大 100)

输出

参数类型描述
customersjson匹配的客户对象数组
metadatajson搜索元数据

stripe_create_subscription

为客户创建一个新订阅

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
customerstring要订阅的客户 ID
itemsjson包含价格 ID 的项目数组(例如,[{"price": "price_xxx", "quantity": 1}])
trial_period_daysnumber试用天数
default_payment_methodstring支付方式 ID
cancel_at_period_endboolean在周期结束时取消订阅
metadatajson用于存储附加信息的键值对集合

输出

参数类型描述
subscriptionjson创建的订阅对象
metadatajson包括 ID、状态和客户的订阅元数据

stripe_retrieve_subscription

通过 ID 检索现有的订阅

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring订阅 ID(例如,sub_1234567890)

输出

参数类型描述
subscriptionjson检索到的订阅对象
metadatajson包括 ID、状态和客户的订阅元数据

stripe_update_subscription

更新现有的订阅

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring订阅 ID(例如,sub_1234567890)
itemsjson更新后的包含价格 ID 的项目数组
cancel_at_period_endboolean是否在周期结束时取消订阅
metadatajson更新的元数据

输出

参数类型描述
subscriptionjson更新后的订阅对象
metadatajson包括 ID、状态和客户的订阅元数据

stripe_cancel_subscription

取消订阅

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring订阅 ID(例如,sub_1234567890)
prorateboolean是否按比例分配取消
invoice_nowboolean是否立即开具发票

输出

参数类型描述
subscriptionjson已取消的订阅对象
metadatajson包括 ID、状态和客户的订阅元数据

stripe_resume_subscription

恢复计划取消的订阅

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring订阅 ID(例如,sub_1234567890)

输出

参数类型描述
subscriptionjson恢复的订阅对象
metadatajson包括 ID、状态和客户的订阅元数据

stripe_list_subscriptions

列出所有订阅

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
limitnumber返回结果的数量(默认 10,最大 100)
customerstring按客户 ID 过滤
statusstring按状态过滤(active, past_due, unpaid, canceled, incomplete, incomplete_expired, trialing, all)
pricestring按价格 ID 过滤

输出

参数类型描述
subscriptionsjson订阅对象数组
metadatajson列表元数据

stripe_search_subscriptions

使用查询语法搜索订阅

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
querystring搜索查询(例如,"status:'active' AND customer:'cus_xxx'")
limitnumber返回结果的数量(默认 10,最大 100)

输出

参数类型描述
subscriptionsjson匹配的订阅对象数组
metadatajson搜索元数据

stripe_create_invoice

创建新发票

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
customerstring客户 ID(例如,cus_1234567890)
descriptionstring发票描述
metadatajson键值对集合
auto_advanceboolean自动完成发票
collection_methodstring收款方式:charge_automatically 或 send_invoice

输出

参数类型描述
invoicejson创建的发票对象
metadatajson发票元数据

stripe_retrieve_invoice

通过 ID 检索现有发票

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring发票 ID(例如,in_1234567890)

输出

参数类型描述
invoicejson检索到的发票对象
metadatajson发票元数据

stripe_update_invoice

更新现有发票

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring发票 ID(例如,in_1234567890)
descriptionstring发票的描述
metadatajson键值对集合
auto_advanceboolean自动完成发票

输出

参数类型描述
invoicejson更新后的发票对象
metadatajson发票元数据

stripe_delete_invoice

永久删除草稿发票

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring发票 ID(例如,in_1234567890)

输出

参数类型描述
deletedboolean发票是否已被删除
idstring已删除发票的 ID
metadatajson删除的元数据

stripe_finalize_invoice

完成草稿发票

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring发票 ID(例如,in_1234567890)
auto_advanceboolean自动推进发票

输出

参数类型描述
invoicejson完成的发票对象
metadatajson发票元数据

stripe_pay_invoice

支付发票

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring发票 ID(例如,in_1234567890)
paid_out_of_bandboolean将发票标记为带外支付

输出

参数类型描述
invoicejson已支付的发票对象
metadatajson发票元数据

stripe_void_invoice

作废发票

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring发票 ID(例如,in_1234567890)

输出

参数类型描述
invoicejson已作废的发票对象
metadatajson发票元数据

stripe_send_invoice

向客户发送发票

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring发票 ID(例如,in_1234567890)

输出

参数类型描述
invoicejson已发送的发票对象
metadatajson发票元数据

stripe_list_invoices

列出所有发票

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
limitnumber返回结果的数量(默认 10,最大 100)
customerstring按客户 ID 过滤
statusstring按发票状态过滤

输出

参数类型描述
invoicesjson发票对象数组
metadatajson列表元数据

stripe_search_invoices

使用查询语法搜索发票

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
querystring搜索查询(例如,"customer:'cus_1234567890'")
limitnumber返回结果的数量(默认 10,最大 100)

输出

参数类型描述
invoicesjson匹配的发票对象数组
metadatajson搜索元数据

stripe_create_charge

创建一个新的收费以处理付款

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
amountnumber金额(以分为单位,例如 2000 表示 $20.00)
currencystring三字母 ISO 货币代码(例如,usd、eur)
customerstring要与此收费关联的客户 ID
sourcestring支付来源 ID(例如,卡片令牌或已保存的卡片 ID)
descriptionstring收费的描述
metadatajson用于存储附加信息的键值对集合
captureboolean是否立即捕获收费(默认为 true)

输出

参数类型描述
chargejson创建的收费对象
metadatajson收费元数据,包括 ID、状态、金额、货币和支付状态

stripe_retrieve_charge

通过 ID 检索现有的收费

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring收费 ID(例如,ch_1234567890)

输出

参数类型描述
chargejson检索到的 Charge 对象
metadatajsonCharge 元数据,包括 ID、状态、金额、货币和支付状态

stripe_update_charge

更新现有的收费

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstringCharge ID(例如,ch_1234567890)
descriptionstring更新的描述
metadatajson更新的元数据

输出

参数类型描述
chargejson更新后的 Charge 对象
metadatajsonCharge 元数据,包括 ID、状态、金额、货币和支付状态

stripe_capture_charge

捕获未捕获的收费

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstringCharge ID(例如,ch_1234567890)
amountnumber捕获的金额(以分为单位,默认为全额)

输出

参数类型描述
chargejson捕获的 Charge 对象
metadatajsonCharge 元数据,包括 ID、状态、金额、货币和支付状态

stripe_list_charges

列出所有收费

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
limitnumber返回结果的数量(默认 10,最大 100)
customerstring按客户 ID 过滤
createdjson按创建日期过滤(例如,{"gt": 1633024800})

输出

参数类型描述
chargesjson收费对象数组
metadatajson列表元数据,包括计数和 has_more

stripe_search_charges

使用查询语法搜索收费

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
querystring搜索查询(例如,"status:'succeeded' AND currency:'usd'")
limitnumber返回结果的数量(默认 10,最大 100)

输出

参数类型描述
chargesjson匹配的收费对象数组
metadatajson搜索元数据,包括计数和 has_more

stripe_create_product

创建一个新的产品对象

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
namestring产品名称
descriptionstring产品描述
activeboolean产品是否处于激活状态
imagesjson产品的图片 URL 数组
metadatajson键值对集合

输出

参数类型描述
productjson创建的产品对象
metadatajson产品元数据

stripe_retrieve_product

通过 ID 检索现有的产品

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring产品 ID(例如,prod_1234567890)

输出

参数类型描述
productjson检索到的产品对象
metadatajson产品元数据

stripe_update_product

更新现有的产品

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring产品 ID(例如,prod_1234567890)
namestring更新的产品名称
descriptionstring更新的产品描述
activeboolean更新的激活状态
imagesjson更新的图片 URL 数组
metadatajson更新的元数据

输出

参数类型描述
productjson更新的产品对象
metadatajson产品元数据

stripe_delete_product

永久删除产品

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring产品 ID(例如,prod_1234567890)

输出

参数类型描述
deletedboolean产品是否已被删除
idstring已删除产品的 ID
metadatajson删除元数据

stripe_list_products

列出所有产品

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
limitnumber返回结果的数量(默认 10,最大 100)
activeboolean按活动状态筛选

输出

参数类型描述
productsjson产品对象数组
metadatajson列表元数据

stripe_search_products

使用查询语法搜索产品

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
querystring搜索查询(例如,"name:'shirt'")
limitnumber返回结果的数量(默认 10,最大 100)

输出

参数类型描述
productsjson匹配的产品对象数组
metadatajson搜索元数据

stripe_create_price

为产品创建一个新的价格

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
productstring产品 ID(例如,prod_1234567890)
currencystring三字母 ISO 货币代码(例如,usd,eur)
unit_amountnumber金额(以分为单位,例如,1000 表示 $10.00)
recurringjson循环计费配置(间隔:天/周/月/年)
metadatajson键值对集合
billing_schemestring计费方案(per_unit 或 tiered)

输出

参数类型描述
pricejson创建的价格对象
metadatajson价格元数据

stripe_retrieve_price

通过 ID 检索现有的价格

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring价格 ID(例如,price_1234567890)

输出

参数类型描述
pricejson检索到的价格对象
metadatajson价格元数据

stripe_update_price

更新现有价格

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring价格 ID(例如,price_1234567890)
activeboolean价格是否为激活状态
metadatajson更新的元数据

输出

参数类型描述
pricejson更新的价格对象
metadatajson价格元数据

stripe_list_prices

列出所有价格

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
limitnumber返回结果的数量(默认 10,最大 100)
productstring按产品 ID 过滤
activeboolean按激活状态过滤

输出

参数类型描述
pricesjson价格对象数组
metadatajson列表元数据

stripe_search_prices

使用查询语法搜索价格

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
querystring搜索查询(例如,"active:'true' AND currency:'usd'")
limitnumber返回结果的数量(默认 10,最大 100)

输出

参数类型描述
pricesjson匹配价格对象的数组
metadatajson搜索元数据

stripe_retrieve_event

通过 ID 检索现有的事件

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
idstring事件 ID(例如,evt_1234567890)

输出

参数类型描述
eventjson检索到的事件对象
metadatajson事件元数据,包括 ID、类型和创建时间戳

stripe_list_events

列出所有事件

输入

参数类型必需描述
apiKeystringStripe API 密钥(secret key)
limitnumber返回结果的数量(默认 10,最大 100)
typestring按事件类型过滤(例如,payment_intent.created)
createdjson按创建日期过滤(例如,{"gt": 1633024800})

输出

参数类型描述
eventsjson事件对象的数组
metadatajson列表元数据,包括计数和 has_more

注意

  • 类别:tools
  • 类型:stripe
On this page

On this page

使用说明
工具
stripe_create_payment_intent
输入
输出
stripe_retrieve_payment_intent
输入
输出
stripe_update_payment_intent
输入
输出
stripe_confirm_payment_intent
输入
输出
stripe_capture_payment_intent
输入
输出
stripe_cancel_payment_intent
输入
输出
stripe_list_payment_intents
输入
输出
stripe_search_payment_intents
输入
输出
stripe_create_customer
输入
输出
stripe_retrieve_customer
输入
输出
stripe_update_customer
输入
输出
stripe_delete_customer
输入
输出
stripe_list_customers
输入
输出
stripe_search_customers
输入
输出
stripe_create_subscription
输入
输出
stripe_retrieve_subscription
输入
输出
stripe_update_subscription
输入
输出
stripe_cancel_subscription
输入
输出
stripe_resume_subscription
输入
输出
stripe_list_subscriptions
输入
输出
stripe_search_subscriptions
输入
输出
stripe_create_invoice
输入
输出
stripe_retrieve_invoice
输入
输出
stripe_update_invoice
输入
输出
stripe_delete_invoice
输入
输出
stripe_finalize_invoice
输入
输出
stripe_pay_invoice
输入
输出
stripe_void_invoice
输入
输出
stripe_send_invoice
输入
输出
stripe_list_invoices
输入
输出
stripe_search_invoices
输入
输出
stripe_create_charge
输入
输出
stripe_retrieve_charge
输入
输出
stripe_update_charge
输入
输出
stripe_capture_charge
输入
输出
stripe_list_charges
输入
输出
stripe_search_charges
输入
输出
stripe_create_product
输入
输出
stripe_retrieve_product
输入
输出
stripe_update_product
输入
输出
stripe_delete_product
输入
输出
stripe_list_products
输入
输出
stripe_search_products
输入
输出
stripe_create_price
输入
输出
stripe_retrieve_price
输入
输出
stripe_update_price
输入
输出
stripe_list_prices
输入
输出
stripe_search_prices
输入
输出
stripe_retrieve_event
输入
输出
stripe_list_events
输入
输出
注意
Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started