You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Stripe内部配置事件触发器?实现订阅取消自动生成贷项通知单

Stripe内部事件触发器与订阅取消后的贷项通知单自动化方案

首先明确:Stripe目前没有提供像Supabase、MongoDB Atlas那样完全在平台内部配置的无代码事件链式触发系统,所有事件驱动的自动化逻辑,要么通过Stripe后台的Rules功能配置(适配有限场景),要么需要结合Webhook+自定义服务实现。

针对你提到的「客户取消订阅且未支付下一期账单时自动生成并发送贷项通知单」的需求,有两种可行方案:

方案一:使用Stripe Rules(有限场景适配)

Stripe Rules是后台内置的轻量自动化工具,可基于特定事件触发预设动作。你可以尝试以下配置:

  • 触发事件选择customer.subscription.deleted(订阅被取消时)
  • 添加条件判断:筛选出「订阅取消原因关联未支付发票」的情况(需依赖事件数据中的cancel_at_period_end或对应发票状态字段)
  • 动作选择「创建贷项通知单」,并开启「发送邮件给客户」选项

注意:Stripe Rules的条件组合能力有限,如果你的需求需要同时校验多个事件(比如既要有订阅取消,又要有对应发票支付失败的记录),可能无法直接满足,这时需要用方案二。

方案二:Webhook + 自定义服务(灵活适配复杂逻辑)

这是更通用的方案,步骤如下:

  1. 配置Webhook监听事件:在Stripe后台添加Webhook端点,监听customer.subscription.deleted和invoice.payment_failed两个核心事件
  2. 验证事件合法性:在你的服务中,用Stripe提供的签名验证方法确认事件来自Stripe,避免伪造请求
  3. 逻辑判断:
    • 当收到customer.subscription.deleted事件时,关联查询该订阅对应的未支付发票(通过事件中的subscription ID调用发票列表接口)
    • 当收到invoice.payment_failed事件时,检查该发票对应的订阅是否已取消
    • 满足「订阅已取消 + 对应发票未支付」的条件后,执行下一步
  4. 创建并发送贷项通知单:调用Stripe API的stripe.creditNotes.create()方法,传入客户ID、对应发票ID,并设置send_email: true参数,自动将贷项通知单发送给客户

关键代码示例(Node.js)

const stripe = require('stripe')('你的API密钥');

// Webhook处理函数
async function handleStripeEvent(event) {
  switch (event.type) {
    case 'customer.subscription.deleted':
      const subscription = event.data.object;
      // 查询该订阅关联的未支付发票
      const invoices = await stripe.invoices.list({
        subscription: subscription.id,
        status: 'open'
      });
      if (invoices.data.length > 0) {
        // 创建贷项通知单
        await stripe.creditNotes.create({
          invoice: invoices.data[0].id,
          amount: invoices.data[0].amount_due,
          send_email: true
        });
      }
      break;
    // 可补充处理invoice.payment_failed事件的逻辑
    default:
      console.log(`未处理的事件类型: ${event.type}`);
  }
}

注意事项

  • 确保Webhook端点的可靠性,建议添加重试机制处理网络波动
  • 实现幂等性:通过事件ID避免重复创建贷项通知单
  • 测试时使用Stripe测试环境,模拟订阅取消和支付失败的场景验证逻辑

内容的提问来源于stack exchange,提问作者Kvetoslav

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.22 16:48:58