集成PayPal REST API时，订阅支付失败触发哪些Webhook事件？

当订阅支付失败时，PayPal会按以下典型逻辑触发Webhook事件，具体流程取决于失败原因和自动重试设置：

核心失败事件 #

• PAYMENT.SALE.FAILED：首次支付尝试失败时立即触发，事件中包含具体失败原因（如余额不足、卡片被拒、支付方式过期等）。
• BILLING.SUBSCRIPTION.PAYMENT.FAILED：与订阅绑定的支付尝试失败时触发，该事件会关联对应订阅ID，方便直接定位到目标用户的订阅记录。

自动重试对应的事件序列（默认开启） #

PayPal默认会对失败的订阅支付进行多轮自动重试，流程如下：

1. 首次支付失败后约3天发起第二次尝试，若仍失败，重复触发PAYMENT.SALE.FAILED和BILLING.SUBSCRIPTION.PAYMENT.FAILED
2. 第二次失败后约5天发起第三次尝试，失败后再次触发上述两个事件
3. 三次尝试全部失败后，触发BILLING.SUBSCRIPTION.SUSPENDED，订阅进入暂停状态
4. 若暂停期间未解决支付问题，最终会触发BILLING.SUBSCRIPTION.CANCELLED，订阅被永久取消

关键注意点 #

• 不同失败类型（如欺诈拦截、卡片过期）可能导致事件触发细节有差异，需在Webhook处理逻辑中解析failure_reason字段判断具体场景
• 若关闭自动重试功能，首次支付失败后会直接触发BILLING.SUBSCRIPTION.SUSPENDED，无后续重试事件

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