| 事件名称 | 事件类型 | 触发时机 | 通知数据结构 | 描述 |
|---|---|---|---|---|
| 试用期即将到期通知 | v2.subscription. trial_period_expiring | 试用期剩余时间小于 3 天时，提醒一次 | Subscription | 用户订阅试用期 3 天后到期 。 使用场景：
|
| 首次订阅通知 | v2.subscription.first | 订阅首次生效时 | Subscription | 订阅首次进入试用期或者活跃状态时通知，每个订阅只会发送一次。 使用场景：
|
| 终止订阅通知 | v2.subscription.canceled | 订阅终止时 | Subscription | 订阅实际终止时通知。 使用场景：
|
| 订阅价格变更 | v2.subscription.price_changed | 订阅价格变更时 | Subscription | 订阅价格变更时，通知变更具体信息。 |
| 订阅暂停 | v2.subscription.paused | 订阅暂停时通知 | Subscription | 订阅暂停时通知，用于同步订阅状态。 使用场景：
|
| 订阅重启 | v2.subscription.resumed | 订阅重启时通知 | Subscription | 订阅从暂停状态恢复时通知。 使用场景：
|
| 订阅逾期 | v2.subscription.past_due | 订阅逾期时通知 | Subscription | 订阅支付逾期时通知，通常在自动续订扣款失败后进入该状态。 使用场景：
|
| 订阅未支付 | v2.subscription.unpaid | 订阅未支付时通知 | Subscription | 订阅因长期未支付而被标记为未支付状态时通知。 使用场景：
|
| 撤回取消订阅 | v2.subscription.cancellation_revoked | 撤回取消订阅时通知 | Subscription | 用户撤回之前的取消订阅请求时通知。 使用场景：
|
| 请求取消订阅 | v2.subscription.cancellation_requested | 请求取消订阅时通知 | Subscription | 用户请求取消订阅时通知，但订阅尚未实际终止。 使用场景：
|
| 订阅固定期限变更 | v2.subscription.fixed_term_updated | 订阅的固定期限被修改时通知 | Subscription | 当订阅的固定期限设置发生变更时通知，包括修改期数、切换是否支持到期转续、转为持续订阅等操作。通知数据中包含
|
| 账单支付成功 | v2.invoice.paid | 一次性商品、首次订阅和订阅续订支付成功时通知 | Invoice | 一次性商品和订阅相关的支付成功时会发送该通知。用于同步账单状态、订阅管理。 使用场景：
|
| 账单支付失败 | v2.invoice.payment_failed | 一次性商品、首次订阅和订阅续订支付失败时通知 | Invoice | 一次性商品和订阅相关的支付失败时会发送该通知。不会每次重试支付失败都通知，只在最终支付失败时通知。 使用场景：
|
| 账单退款 | v2.invoice.refunded | 当订阅产生的交易单退款成功时通知，用于获取订阅退款信息 | Invoice | 一次性商品和订阅相关的支付发生退款时会发送该事件。用于同步退款状态。 |
| 交易单支付成功 | v2.trades.succeeded | 支付成功时 | Trade | 所有类型的支付成功时会发送该通知，适用于纯金额交易的闭环。 |
| 交易单支付失败 | v2.trades.payment_failed | 支付失败时 | Trade | 所有类型的支付失败时会发送该通知，适用于纯金额交易的闭环。 |
| 退款成功 | v2.refunds.succeeded | 退款成功时 | Refund | 退款实际完成时通知。 使用场景：
|
| 退款失败 | v2.refunds.failed | 退款失败时 | Refund | 退款实际失败时通知 使用场景：
|
| 争议创建通知 | v2.disputes.created | 争议首次创建时 | Dispute | 渠道首次回传争议数据时通知，每个
|
| 争议更新通知 | v2.disputes.updated | 争议关键字段变化时 | Dispute | 已存在的争议在状态、原因、金额或截止时间等关键字段发生变化时通知。 使用场景：
|