PayPal API中Webhooks处理CHECKOUT.ORDER.APPROVED与PAYMENT.CAPTURE.COMPLETED的疑问

一、两个Webhook的触发顺序与业务逻辑确认 #

你的理解是正确的：

• CHECKOUT.ORDER.APPROVED会先触发：代表用户已在PayPal端完成订单授权（同意扣款），但此时资金还未实际到账。
• PAYMENT.CAPTURE.COMPLETED后触发：只有当PayPal成功完成资金扣取并确认到账后，这个事件才会触发。

确实存在订单已批准但支付未完成的异常场景（比如用户账户余额不足、支付渠道临时故障等），所以必须等待PAYMENT.CAPTURE.COMPLETED触发后，再向用户开放付费内容权限，这是正确的业务逻辑。

二、能否依赖触发顺序确保订单存在？ #

不建议直接依赖Webhook的触发顺序来保证订单已存在，原因如下：

1. Webhook可能延迟或乱序：网络波动、PayPal服务器调度等情况，都可能导致PAYMENT.CAPTURE.COMPLETED先于CHECKOUT.ORDER.APPROVED到达你的服务，或者前者到达时后者的数据库写入还未完成。
2. Webhook可能丢失：极端情况下，CHECKOUT.ORDER.APPROVED事件可能因网络问题完全丢失，导致PAYMENT.CAPTURE.COMPLETED触发时数据库中没有对应订单。

正确处理方式： #

• 处理PAYMENT.CAPTURE.COMPLETED事件时，先根据事件中的订单ID查询数据库：
  • 若订单存在，直接进行权限开放等后续操作；
  • 若订单不存在，调用PayPal的订单查询API（通过事件中的订单ID获取完整订单信息），补创建订单到数据库后再完成后续处理。
• 给CHECKOUT.ORDER.APPROVED的处理逻辑加上幂等性校验：如果数据库中已存在该订单ID的记录，直接跳过创建操作，避免重复写入。

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