关于stripe.checkout.sessions.create(...)指定Webhook目标及多站点Webhook触发规则的技术咨询

1. 如何让Stripe Checkout使用指定的Webhook目标？ #

其实Stripe Checkout创建会话时，不需要直接指定Webhook目标。Webhook的触发逻辑是：当Stripe产生特定事件（比如checkout.session.completed）时，会把事件发送给所有在你账户中配置了监听该事件类型的Webhook端点。

如果需要区分不同网站的事件（对应不同Webhook），有两种实用方案：

• 方案一：给Checkout会话添加元数据标记
  调用stripe.checkout.sessions.create()时，加入metadata字段自定义网站标识，比如：

  const session = await stripe.checkout.sessions.create({
    payment_method_types: ['card'],
    line_items: [...],
    mode: 'payment',
    success_url: 'https://your-site.com/success',
    cancel_url: 'https://your-site.com/cancel',
    metadata: {
      site_id: 'mydestination-mymarket' // 对应你的Webhook目标自定义名称
    }
  });
  

  当Webhook事件触发时，你可以在事件对象的data.object.metadata里拿到这个标识，然后在Webhook处理程序里根据标识执行对应网站的业务逻辑——哪怕多个Webhook收到事件，也能通过元数据过滤掉不属于自己的请求。

• 方案二：给Webhook设置事件过滤逻辑
  如果你希望某个Webhook只接收特定网站的事件，可以在Stripe控制台配置Webhook后，在处理程序里通过元数据、success_url等唯一标识过滤请求，直接忽略不属于当前网站的事件。

2. 多个Webhook目标会同时被触发吗？ #

是的，如果你给两个Webhook目标都配置了监听相同的事件类型（比如checkout.session.completed），那么当任意一个网站发生购买并产生该事件时，两个Webhook端点都会收到事件通知。

如果不想让无关Webhook被触发，你可以：

• 给不同Webhook配置不同的监听事件类型（业务允许的情况下）；
• 在Webhook处理程序中通过会话元数据、专属域名等标识过滤请求，跳过非目标网站的事件；
• （不推荐）给不同网站使用独立的Stripe账户，不过这会增加管理成本。

内容的提问来源于stack exchange，提问作者damix911