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

最新推荐文章于 2024-07-26 09:29:41 发布
置顶 最新推荐文章于 2024-07-26 09:29:41 发布
阅读量1.5k 收藏
点赞数 1
分类专栏： PayPal 技术
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/ml344739968/article/details/113357365
版权

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

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

webhook官方文档
Paypal纠纷文档

交易通知流程

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

退款通知流程

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

争议通知流程（纠纷）

  1. 创建争议（事件类型：CUSTOMER.DISPUTE.CREATED / RISK.DISPUTE.CREATED）
  2. 更新争议状态（事件类型：CUSTOMER.DISPUTE.UPDATED）
  3. 解决争议（事件类型：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>
        /// <returns></returns>
        public ActionResult Notify()
        {
            var orderId = 0;
            string ip = Vayava.Common.ClientHelper.GetIp();//获取客户端请求IP
            // Get the received request's headers
            var requestHeaders = Request.Headers;
            // Get the received request's body
            var requestBody = string.Empty;
            using (var reader = new StreamReader(Request.InputStream))
            {
                requestBody = reader.ReadToEnd();
            }
            try
            {
                // 务必验证回调通知来自于PayPal，否则可能是恶意攻击
                var isValid = PaypalUtils.ValidateReceivedEvent(requestHeaders, requestBody);
                if (isValid)
                {
                    PaymentHepler.WriteDetailLog(PaypalUtils.LogName, $"pay paypal notify is start, ip: {ip}, valid success, json: {requestBody}");
                    var request = Newtonsoft.Json.JsonConvert.DeserializeObject<Event<Object>>(requestBody);
                    var resourceType = request?.ResourceType.ToUpper();
                    var eventType = request?.EventType.ToUpper();
                    if (resourceType == "DISPUTE")   // 争议流程
                    {
                        #region 纠纷状态更新
                        var resource = Newtonsoft.Json.JsonConvert.DeserializeObject<Dispute>(request.Resource.ToString());
                        Int32.TryParse(resource?.DisputedTransactions.FirstOrDefault()?.InvoiceNumber, out orderId);
                        var disputeId = resource?.DisputeId; // 纠纷ID
                        var disputeDate = Convert.ToDateTime(resource?.CreateTime); // 纠纷日期
                        var reason = resource?.Reason; // 纠纷类型
                        var disputeCurrencyCode = resource?.DisputeAmount.CurrencyCode; // 纠纷金额币种
                        var disputeAmount = Convert.ToDecimal(resource?.DisputeAmount.Value);  // 纠纷金额
                        var status = resource?.Status?.ToUpper(); // 纠纷状态
                        var disputeOutcome = resource?.DisputeOutcome?.OutcomeCode; // 纠纷处理结果
                        var remark = resource?.Messages?.LastOrDefault()?.Content; // 获取最后一个备注内容
                        var disputeLifeCycleStage = resource?.DisputeLifeCycleStage; // 争议生命周期中的阶段。
                        var disputeChannel = resource?.DisputeChannel;  // 客户提出争议的渠道。
                        var caseState = default(CaseStateEnum);
                        var caseReason = (CaseReasonEnum)Enum.Parse(typeof(CaseReasonEnum), reason);
                        var caseType = this.GetPaypalCaseType(disputeLifeCycleStage, disputeChannel);
                        if (eventType == "CUSTOMER.DISPUTE.CREATED" || eventType == "RISK.DISPUTE.CREATED")
                        {
                            // 创建争议
                            caseState = CaseStateEnum.Open;
                        }
                        else if (eventType == "CUSTOMER.DISPUTE.UPDATED")
                        {
                            switch (status)
                            {
                                case "WAITING_FOR_SELLER_RESPONSE":
                                    caseState = CaseStateEnum.WaitingForSellerResponse;
                                    break;
                                case "WAITING_FOR_BUYER_RESPONSE":
                                    caseState = CaseStateEnum.WaitingForBuyerResponse;
                                    break;
                                case "UNDER_REVIEW":
                                    caseState = CaseStateEnum.UnderReview;
                                    break;
                                case "RESOLVED":
                                    caseState = CaseStateEnum.Resolved;
                                    break;
                                case "OPEN":
                                    caseState = CaseStateEnum.Open;
                                    break;
                                default:
                                    caseState = CaseStateEnum.Other;
                                    break;
                            }
                        }
                        else if (eventType == "CUSTOMER.DISPUTE.RESOLVED")
                        {
                            // 解决争议
                            caseState = CaseStateEnum.Resolved;
                        }
                        // 
                        this.SetOrderDisputeState(orderId, disputeId, caseType, caseState, caseReason,
                                 disputeCurrencyCode, disputeAmount, disputeDate, disputeOutcome, remark);
                        #endregion
                    }
                    else if (resourceType == "REFUND") // 退款流程
                    {
                        #region 退款状态更新
                        var resource = Newtonsoft.Json.JsonConvert.DeserializeObject<DetailedRefund>(request.Resource.ToString());
                        Int32.TryParse(resource.InvoiceNumber, out orderId);
                        var state = resource?.State.ToUpper();
                        var currency = resource?.Amount.Currency;
                        var amount = Convert.ToDecimal(resource?.Amount?.Total); // 退款总金额 = 总净额 + Paypal费用
                        var receivedAmount = resource?.RefundFromReceivedAmount?.Value; // 总净额
                        var transactionFee = resource?.RefundFromTransactionFee?.Value; // PayPal费用
                        var transactionId = resource?.Id; // 退款交易ID
                        var remark = $"总净额: {receivedAmount}, PayPal费用: {transactionFee}";
                        if (eventType == "PAYMENT.SALE.REFUNDED")
                        {
                            // 退款完成
                            this.SetOrderRefundState(orderId, false, currency, amount, transactionId, remark);
                        }
                        #endregion
                    }
                    else if (resourceType == "SALE")  // 交易流程
                    {
                        #region 付款状态更新
                        var resource = Newtonsoft.Json.JsonConvert.DeserializeObject<Sale>(request.Resource.ToString());
                        Int32.TryParse(resource.InvoiceNumber, out orderId);

                        var state = resource?.State.ToUpper();
                        var currency = resource?.Amount.Currency;
                        var amount = Convert.ToDecimal(resource?.Amount?.Total);
                        var transactionId = resource?.Id;
                        var paymentMethod = PaymentMethod.Paypal;
                        var remark = $"{eventType}";
                        if (eventType == "PAYMENT.SALE.COMPLETED")
                        {
                            // 付款完成
                            this.SetOrderPaymentState(orderId, 2, currency, amount, transactionId, paymentMethod, remark);
                        }
                        else if (eventType == "PAYMENT.SALE.PENDING")
                        {
                            // 付款pending
                            this.SetOrderPaymentState(orderId, 1, currency, amount, transactionId, paymentMethod, remark);
                        }
                        else if (eventType == "PAYMENT.SALE.DENIED")
                        {
                            // 付款拒绝
                            this.SetOrderPaymentState(orderId, 0, currency, amount, transactionId, paymentMethod, remark);
                        }
                        #endregion
                    }
                }
                else
                {
                    // 验签失败
                    PaymentHepler.WriteDetailLog(PaypalUtils.LogName, $"pay paypal notify valid SignMsg is failed.", orderId);
                    return Content("1");
                }
            }
            catch (Exception ex)
            {
                PaymentHepler.WriteDetailLog(PaypalUtils.LogName, $"pay paypal notify, ex: {ex.ToString()}", orderId);

            }
            return Content("1");
        }

        /// <summary>
        /// 得到纠纷类型
        /// 客户联系PayPal， 纠纷查询阶段
        /// 客户联系PayPal，纠纷索赔阶段
        /// 客户联系其发卡行或银行要求退款。(不经过paypal)
        /// </summary>
        /// <param name="disputeLifeCycleStage"></param>
        /// <param name="disputeChannel"></param>
        /// <returns></returns>
        private CaseTypeEnum GetPaypalCaseType(string disputeLifeCycleStage, string disputeChannel)
        {
            var caseType = CaseTypeEnum.Dispute;
            if (string.IsNullOrEmpty(disputeLifeCycleStage) || string.IsNullOrEmpty(disputeChannel))
                return caseType;
            if (disputeLifeCycleStage.ToUpper() == "INQUIRY" && disputeChannel.ToUpper() == "INTERNAL")
            {
                // 客户联系贝宝（PayPal）向商家提出争议, 此时处于纠纷查询阶段
                caseType = CaseTypeEnum.Dispute;
            }
            else if (disputeLifeCycleStage.ToUpper() == "CHARGEBACK" && disputeChannel.ToUpper() == "INTERNAL")
            {
                // 客户联系贝宝（PayPal）向商家提出争议, 此时处于纠纷索赔阶段
                caseType = CaseTypeEnum.Claim;
            }
            else if (disputeLifeCycleStage.ToUpper() == "CHARGEBACK" && disputeChannel.ToUpper() == "EXTERNAL")
            {
                // 客户联系其发卡行或银行要求退款。
                caseType = CaseTypeEnum.Chargeback;
            }
            return caseType;
        }
        #endregion

电商支付（一）

电商支付（二）

Simon.m
关注
专栏目录
PayPal-NET-SDK:用于PayPal RESTful API的.NET SDK
04-12
弃用通知： 不建议使用此SDK。 您可以继续使用它，但是不会接受任何新功能或支持请求。 有关替代方法，请访问 贝宝.NET SDK PayPal .NET SDK是基于构建的，可轻松向您的.NET Web应用程序添加PayPal支持。 TLSv1.2更新 支付卡行业（PCI）理事会已从服务中停用TLS的早期版本。 所有处理信用卡信息的组织都必须遵守此标准。 作为这项义务的一部分，贝宝（PayPal）正在更新其服务，以要求所有HTTPS连接都使用TLS 1.2。 目前，贝宝还将要求所有连接都使用HTTP / 1.1。 了解更多信息 与沙盒环境的连接仅使用TLS 1.2。 PayPal Checkout v2 请注意，如果您要与PayPal Checkout集成，则此SDK和相应的API 即将被弃用。 我们建议您与API 和集成。 请参考继续进行集成。 2.0发布候选！ 我们正在发布
PAYPAL支付开发简介
qq_43455733的博客
07-09 2534
PAYPAL支付开发简介一 普通支付（一次性商品购买）网页支付客户端SDK支付二 paypal连续包月创建一个订阅三 通知PDTIPNwebHook 本简介主要是给开发者一个参考，没有具体实现，也没有demo。但是，根据教程对paypal也能有个全方位的了解。 集成paypal支付需要先进入https://www.paypal.com/c2/home注册商家账户，然后进入https://developer.paypal.com/开发者平台，登录后点击默认应用可以查看账户的id和secret 一 普通支付（一
Python实现自动化工作流之Webhook接口使用详解
最新发布
Rocky006的博客
07-26 1321
在现代软件开发中，Webhook是一种常用的技术，它允许应用程序通过HTTP POST请求向另一个应用程序发送实时数据。Webhook通常用于事件驱动的通知系统，例如，当某个事件发生时（如推送代码、支付成功等），自动向指定的URL发送数据通知。本文将详细介绍如何使用Python编写Webhook接口，包括基本概念、使用Flask框架实现Webhook接口，以及实际应用场景和示例代码。
前端-pc端对接paypal支付（vue3）
dhdndnbdb的博客
02-17 1480
currency_code: 'USD', // 更换实际币种。locale: 'zh_CN', //按钮的语言locale: 'en_US'description: '购买', // 更换实际订单描述。layout: 'vertical', //按钮样式。label: 'checkout', //按钮文本。// 取消付款 点击底部的取消并返回执行。color: 'gold', //颜色。// 用户点击付款按钮的时候执行。
PayPal 支付-Checkout 收银台和 Subscription 订阅计划全过程分享
lxw1844912514的博客
02-26 3435
废话不多说，我们先从请求的生命周期来分析，逐步实现整个过程. 一。生命周期 1. Checkout - 收银台支付 拆解流程如图所示 (过程类似支付宝的收银台): 流程详解: 本地应用组装好参数并请求 Checkout 接口，接口同步返回一个支付 URL; 本地应用重定向至这个 URL, 登陆 PayPal 账户并确认支付，用户支付后跳转至设置好的本地应用地址； 本地请求 PayPal 执行付款接口发起扣款； PayPal 发送异步通知至本地应用，本地拿到数据包后进行验签操作； 验签成功则进
c# .net PayPal支付验证
zhong0_01的博客
03-30 1206
系列文章目录 c# .net Paypal支付Webhooks回调验证 文章目录系列文章目录前言一、 PayPal支付？二、步骤1.引入2.config配置文件3.业务代码总结 前言 记录一下，那些年踩过的坑！ 一、 PayPal支付？ 官方主页 官方开发文档 二、步骤 1.引入 using Newtonsoft.Json.Linq; using PayPal.Api; using System; using System.IO; using System.Net;
.Net在线付款---Paypal在线付款开发过程
jimlong的专栏
03-13 3583
.Net在线付款---Paypal在线付款开发过程 作者：不高很瘦  来源：博客园  发布时间：2011-08-02 10:55  阅读：334 次  原文链接   [收藏]       最近在做一个Web订单项目，项目有一个需求就是集成Paypal与Paydollar在线付款,一开始看到这个需求也是傻了眼,因为以前从来没有做过在线付款的功能,于是打开百度,google狂搜一通
电商支付-Paypal普通支付对接基于Restful-api-v1.Net（二）
ml344739968的专栏
11-21 568
前言 跨境电商行业中，支付环节相信大家都不陌生，对接的国外支付平台可能很多，但是PayPal作为全球最重要的支付方式之一，支付转化率也有保证，一直深受各跨境电商平台青睐，本章将继续介绍PayPal对接示例实战， 本次讲解是针对PayPal官方文档Payments支付流程介绍，基于.Net代码示例 PayPal参考文档 名词解释 同步回调：及时处理支付状态的处理流程 异步回调：异步处理支付状态的处理流程（支付状态最终以异步回传为准） 配置准备工作 登录PayPal沙盒开发者中心， endpoint：
.Net Core 开发电商后端API 从0到精通吃透REST-FakeXiecheng.API.zip
01-31
总之，《.Net Core 开发电商后端API 从0到精通》旨在通过FakeXiecheng.API项目，让你深入了解.Net Core的API开发，包括RESTful设计、身份验证、数据库集成、性能优化等多个方面，助你在电商领域游刃有余，开发出高...
springboot-restful-starter：SpringBoot RESTful API脚手架
02-05
springboot-restful-starter SpringBoot RESTful API脚手架简介这是一个基于SpringBoot 2.1.1 RELEASE ，用于构建RESTful API工程的脚手架，只需三分钟你就可以开始编写业务代码，不再烦恼于建造项目与风格统一。...
Koa2-API-Scaffold：一个基于Koa2的轻量级RESTful API服务器脚手架
02-03
这是一个基于Koa2的轻量级RESTful API Server脚手架，支持ES6。 注意：因升级Koa版本至2.3.0+，为配合相应的依赖项，故需要Node.js版本大于等于v8.0.0（建议v11.13.0），NPM大于等于v5.0.0。建议使用yarn代替npm。 ...
汽车消费ASP-.Net-Core-WebApi
02-02
【标题】"汽车消费ASP-.Net-Core-WebApi"是一个基于ASP.NET Core Web API开发的项目，用于处理汽车消费相关的数据交互。这个项目利用了现代Web开发的技术栈，结合了前端与后端的能力，提供了高效、可靠的服务。 ...
Python对接支付系统
weixin_41850878的博客
07-09 1071
在Python中对接支付系统，通常涉及到与第三方支付提供商的API进行交互。这可能包括但不限于PayPal、Stripe、Braintree、Alipay、WeChat Pay等。下面我将概述一个基本的流程，以使用Python与支付网关集成为例，这里以Stripe为例进行说明。
paypal支付对接(付款方式：即时付款、快速付款)：PC端支付、APP端支付，异步回调IPN
热门推荐
博客简介
06-12 1万+
最近几天公司项目接入paypal支付，跟同事一路磕磕绊绊，各种邮件联系技术客服，各种等邮件，最后终于对接完成。中间遇到最大的坑，是APP端支付，IPN异步回调，一直不请求回调，该设置的回调地址都设置了好几遍，就在绝望时，昨晚抱着试试看的心态测试了一单，竟然回调了！！！沙盒环境调通了！！！可以安心切到生产环境了！！！paypal支付各种坑各种截图各种配置......
关于 PAYPAL对接纠纷模块--send_message
csdn1314hjb的博客
12-18 565
1：近来工作上需要对接paypal ，有关支付，退款等等都有相关的SDK集成。但是此时的项目需求，我需要对接的纠纷模块，然而paypal相关的纠纷是没有现成的SDK的。所以只能自己写；里面有多种种坑道记录一下。 下面是对接paypal 纠纷数据 拓展中的 争议信息回复 。 功能点：其中发送信息和用户交互 ，其中包含了 多文件上传的功能（小弟能力有限，里面遇到坑道，在下面记录一下，若有同样问题，可以参考参考）； HttpPost httpPost = new Htt...
php paypal 支付回调,PayPal的Restful-API方式退款、WEB支付、回调
weixin_35125164的博客
03-11 795
记录之用。1.移动App中想要接入PayPal支付，婉转的采用PayPal的一种最简便的方式(网页版)。PayPal支付商品名称：流量支付订单编号：{$out_trade_no}金额：${$order_total}border="0"name="submit"alt="PayPal-Thesafer,easierwaytopayonline">这方式就是支付的时候体验不...
PayPal WebHook事件异步通知
123456789
04-01 2276
此篇博文讲述了webhook的配置及使用PHP对webhook消息进行验证。
一行代码解决paypal对接回调验证_notify-validate报INVALID错误
huyanbinweb的专栏
04-22 1090
paypal对接回调验证_notify-validate报INVALID问题完美解决
WSMO-Lite与hRESTS：Web服务与RESTful API的轻量化语义注解
WSMO-Lite和HRESTS是面向服务计算领域中的关键概念，尤其是针对Web服务和RESTful API的轻量级语义注解。随着服务导向计算的发展，服务描述的准确性和自动化变得尤为重要，特别是在与语义技术结合时。2007年，World ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值