电商支付-Paypal普通支付对接基于Restful-api-v1处理纠纷/退款回调通知.Net（三）

PayPal Webhook事件处理与争议管理逻辑解析

最新推荐文章于 2024-07-26 09:29:41 发布

原创

最新推荐文章于 2024-07-26 09:29:41 发布 · 置顶 · 1.8k 阅读

0 ·

CC 4.0 BY-SA版权

本文详细介绍了PayPal的Webhook事件处理机制，包括支付成功、支付拒绝、退款和争议等流程。针对不同事件类型，如PAYMENT.SALE.COMPLETED、PAYMENT.SALE.DENIED、PAYMENT.SALE.REFUNDED和CUSTOMER.DISPUTE创建、更新、解决，文章展示了如何使用API进行状态更新和业务逻辑处理。同时，文章还涵盖了争议的生命周期阶段和管理流程，包括咨询阶段、索赔阶段和结算阶段，以及对应的处理代码示例。

Paypal支付Api v1是基于webhook方式处理回调通知，比PayPal IPN处理方式优雅很多，webhook将以事件分类模式将各类事件明确分类处理，这样对接方式就可以很清晰处理各种通知流程，以下将详细介绍回调处理的所有逻辑

关于PayPal关于webhook通知处理逻辑文档

webhook官方文档
 Paypal纠纷文档

交易通知流程

支付成功（事件类型：PAYMENT.SALE.COMPLETED）
支付拒绝（事件类型：PAYMENT.SALE.DENIED）
支付pending （针对电子支票，PayPal有一个中间确认状态）（事件类型：PAYMENT.SALE.PENDING）

退款通知流程

退款成功（事件类型：PAYMENT.SALE.REFUNDED）

争议通知流程（纠纷）

创建争议（事件类型：CUSTOMER.DISPUTE.CREATED / RISK.DISPUTE.CREATED）
更新争议状态（事件类型：CUSTOMER.DISPUTE.UPDATED）
解决争议（事件类型：CUSTOMER.DISPUTE.RESOLVED）

争议生命周期阶段

要了解争议管理流程，请了解争议的生命周期阶段：

咨询阶段

在客户通过在解决中心报告问题提出争议之后，立即进行查询阶段。客户和商家尝试在20天的时间内解决争议，而不会升级到PayPal。

索赔阶段

如果客户和商家无法在20天的查询期内解决争议，则客户或商家可以将争议升级为PayPal。争议随后进入索赔阶段。

结算阶段

为了解决索赔，PayPal考虑提交的证据并以客户或商人的名义解决争议，并将争议的结果传达给银行（如果涉及）以及商人和客户。

争议管理流程

争议可以在查询阶段或索赔阶段解决。争端解决后，便进入和解阶段。

代码如下：

#region V1异步处理请求
        /// <summary>
        /// webhook 异步通知处理
        /// https://developer.paypal.com/docs/integration/direct/webhooks/rest-webhooks/#verify-event-notifications
        /// https://developer.paypal.com/docs/integration/direct/customer-disputes/webhooks/?mark=disputed_transactions#webhook-details
        /// </summary>