能否通过stripe.checkout.sessions.create(...)指定Webhook目标？多网站场景下Webhook触发规则咨询

首先得明确一个关键点：默认情况下，只要你的Webhook端点订阅了对应的事件类型（比如checkout.session.completed），所有匹配该类型的事件都会发送到这个端点。所以如果你给两个网站注册的Webhook端点都订阅了相同的结账事件，那用户在任意一个网站完成购买时，两个端点都会收到通知——这显然不是你想要的结果。

下面给你两种实用的解决思路：

方法1：用Metadata标记网站，在Webhook中过滤 #

这是最直接且灵活的方式，核心是给每个网站的Checkout会话打上专属标识，然后在Webhook处理逻辑里判断是否要处理该事件。

步骤1：创建会话时添加网站标识 #

在调用stripe.checkout.sessions.create()时，通过metadata字段传入网站的唯一标识（比如你的目标名称mydestination-mymarket）：

// 示例代码（Node.js）
const session = await stripe.checkout.sessions.create({
  payment_method_types: ['card'],
  line_items: [{
    price: 'price_123',
    quantity: 1,
  }],
  mode: 'payment',
  success_url: 'https://mymarket.com/success',
  cancel_url: 'https://mymarket.com/cancel',
  metadata: {
    website_identifier: 'mydestination-mymarket' // 标记当前会话属于哪个网站
  }
});

步骤2：在Webhook处理程序中过滤 #

当你的Webhook收到事件时，先提取会话的metadata，只处理匹配当前网站标识的事件：

// Webhook处理示例
app.post('/webhook', async (req, res) => {
  const event = req.body;
  // 只处理结账完成事件
  if (event.type === 'checkout.session.completed') {
    const session = event.data.object;
    // 根据metadata判断是否属于当前网站
    if (session.metadata.website_identifier === 'mydestination-mymarket') {
      // 执行当前网站的业务逻辑，比如更新订单状态、发送邮件等
      console.log('处理mymarket网站的订单');
    } else {
      // 忽略不属于当前网站的事件
      return res.status(200).json({ received: true });
    }
  }
  res.status(200).json({ received: true });
});

方法2：利用Stripe控制台的事件过滤功能 #

Stripe支持给Webhook端点添加事件过滤规则，让端点只接收符合特定条件的事件，从源头避免无关事件进入你的处理程序。

操作步骤： #

1. 登录Stripe控制台，进入「Developers」→「Webhooks」页面
2. 找到你为某个网站创建的Webhook端点，点击「Edit」
3. 滚动到「Filter events」部分，点击「Add filter rule」
4. 设置过滤条件：
   • 选择事件属性：比如checkout.session.metadata.website_identifier
   • 选择匹配方式：「equals」
   • 填入对应网站的标识：比如mydestination-mymarket
5. 保存设置后，这个端点只会收到带有该标识的Checkout会话事件

重复以上步骤给另一个网站的Webhook端点设置对应的过滤规则，这样两个端点就会各自接收对应网站的事件，不会互相干扰。

额外提示 #

如果不想用metadata，也可以通过会话的success_url/cancel_url里的域名来做判断（比如检查session.success_url是否包含mymarket.com），但metadata的方式更清晰、更不容易出错，毕竟域名可能会有变动。

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