Stripe自定义支付流程中，为何成功事件先于客户端回调发送至Webhook？

这种情况完全可能，而且属于Stripe正常的异步行为逻辑。

原因分析 #

Stripe的Webhook事件通知与用户端的重定向流程是完全独立、异步执行的，两者没有严格的先后顺序约束：

• 当付款成功时，Stripe后台会同时触发两个并行动作：向你的Webhook端点发送payment_intent.succeeded事件，以及响应用户端的重定向请求到return_url。
• 这两个流程的执行速度受网络延迟、服务器负载、请求处理耗时等多种因素影响，完全有可能出现Webhook事件先到达你的服务器，而用户还未完成重定向跳转的情况。

解决方案 #

你当前依赖return_url请求绑定Payment Intent ID和订单ID的设计，会因为异步流程的不确定性出现问题，建议调整为以下逻辑：

• 创建Payment Intent时绑定订单ID：调用Stripe API创建Payment Intent时，通过metadata字段把订单ID嵌入进去，示例伪代码：

  stripe.paymentIntents.create({
    amount: 1000,
    currency: 'usd',
    metadata: { order_id: 'YOUR_ORDER_ID' }
  });
  

• 优先通过Webhook处理付款成功逻辑：收到payment_intent.succeeded事件时，直接从事件对象的data.object.metadata.order_id提取订单ID，完成Payment Intent与订单的关联，并标记订单为已付款状态。
• 兼容return_url场景：用户跳转至return_url时，先检查订单是否已通过Webhook完成处理，若已处理则仅展示成功页面；若未处理，则执行关联逻辑并做幂等校验（避免重复操作）。

关键注意事项 #

• 必须保证Webhook事件的处理是幂等的，比如通过记录已处理的Payment Intent ID来避免重复执行逻辑，因为Stripe会在事件未得到正确响应时进行重试。
• 永远不要假设Webhook事件和用户端操作有固定的先后顺序，异步系统的执行顺序是不可预测的。

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