如何在Stripe Webhook响应中正确获取Charge对象？

问题根源 #

你的Webhook事件路由逻辑出现错误，将payment_intent.succeeded事件错误分发到了charge.succeeded的处理分支，导致把PaymentIntent对象强制当作Charge对象处理，触发类型转换异常。

具体修复步骤 #

1. 严格校验事件类型，修正路由逻辑

   • 检查代码中的事件判断条件，确保每个事件类型对应正确的处理分支，避免字符串拼写错误或逻辑判断失误（比如把===写成=，或错误使用逻辑运算符）。
   • 推荐用switch-case替代多分支if-else，提升代码可读性和准确性。

2. 从PaymentIntent关联获取Charge（若业务需要）
   如果你的业务必须用到Charge数据，不要直接将event.data.object当作Charge对象，而是通过PaymentIntent的关联字段获取：

   • 一个PaymentIntent通常对应一个Charge，可从paymentIntent.charges.data列表中取出第一个Charge的ID，再用Stripe SDK查询完整Charge对象。

3. 添加日志与错误捕获

   • 在每个处理分支开头添加事件类型日志，方便快速定位路由错误，比如：console.log('当前处理事件类型:', event.type);
   • 对对象属性访问、类型转换的代码添加try-catch块，避免Webhook整体崩溃，同时记录详细错误信息。

错误代码与修正示例 #

错误代码（导致异常的原因）

// 错误：事件判断逻辑混乱，可能把payment_intent.succeeded误判为charge.succeeded
if (event.type === 'charge.succeeded') {
  const charge = event.data.object; // 此时event.data.object是PaymentIntent，类型不匹配
  // 处理Charge逻辑
}

修正后的代码

// 用switch-case严格匹配事件类型
switch(event.type) {
  case 'payment_intent.succeeded':
    console.log('处理payment_intent.succeeded事件');
    const paymentIntent = event.data.object;
    // 若需要Charge数据，从关联字段获取
    if (paymentIntent.charges.data.length > 0) {
      const chargeId = paymentIntent.charges.data[0].id;
      const charge = await stripe.charges.retrieve(chargeId);
      // 处理Charge逻辑
    }
    // 处理PaymentIntent逻辑
    break;
  case 'charge.succeeded':
    console.log('处理charge.succeeded事件');
    const charge = event.data.object;
    // 处理Charge逻辑
    break;
  default:
    console.log(`未处理的事件类型：${event.type}`);
}

额外验证步骤 #

• 使用Stripe CLI分别触发payment_intent.succeeded和charge.succeeded测试事件，验证路由逻辑是否正确。
• 查看Stripe Dashboard的Webhook事件记录，确认实际发送的事件类型与代码处理逻辑匹配。

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