.Net在线付款---Paypal在线付款开发过程

原文: .Net在线付款---Paypal在线付款开发过程

    最近在做一个Web订单项目，项目有一个需求就是集成Paypal与Paydollar在线付款,一开始看到这个需求也是傻了眼,因为以前从来没有做过在线付款的功能,于是打开百度,google狂搜一通，发现.net下面集成这两种付款方式的介绍很不全面,没有找到我心中想要的答案,没有办法，只要老老实实的跟着网站上提供的文文件来做,在项目快完成时,于是想将现在做的一些心得和步骤记录下来,以备以后有用!

 

你可以进入https://www.paypal.com/了解Paypal的更多内容.

你可以進入https://www.paypal-biz.com/developer/ 下載相關的技術文檔

或者直接點擊下載本文相關的文檔:

即时付款通知指南

https://www.paypal-biz.com/development/documentation/PayPal_IPN&PDT_Guide_V1.0.pdf

网页付款标准版集成指南

https://www.paypal-biz.com/development/documentation/PayPal_WPS_Guide_V1.0.pdf

Sandbox測試環境使用指南

https://www.paypal-biz.com/development/documentation/PayPal_Sandbox_Guide_V1.0.pdf

 

 

 

你在做asp.net集成Paypal在线付款需要以下的条件:

1.       需要有.net开发基础(废话).

2.       需要有一个在外网可以访问到的网址.

3.       需要仔细阅读Paypal集成文檔,以备参考.

4.       需要注册Paypal的正式账号与测试账号(本文以测试账号为例).

 

假定我们现在的系统叫Order系统,需要集成在线付款,本文按照如下的流程来讲述Paypal的开发过程:

1.       註冊Paypal的测试账号.

2.       编写一个HTML Form 将订单的一些相关信息POST到Paypal的页面上去.

3.       提供一个页面用于让Paypal更新我们的Order系统.

4.       返回到Order系统的提示页面.

 

 

一 获得Paypal的测试账号

Paypal为我们提供一个可以测试的虚拟付款的付款网站:

http://www.sandbox.paypal.com/

界面上要求你用Email Address和password来登录，和PayDollar不同的是paypal提供了測試環境的註冊帳號,如果你沒有帳號，可以點擊Sing Up Now註冊一個paypal的測試帳號.

註冊完成後,可以用剛註冊的帳號登錄,再點擊Test Account,然後再註冊一個Business帳號和一個personal帳號，分別用於模擬買家與賣家,或者叫做接款方和付款方.

在注冊business帳號和personal帳號時,會要求你和信用卡與借記卡關聯(這一些信息都可以為假的!).

 

你可以進入官網了解或者百度一下,網上怎樣註冊帳號的資料很多.

 

 

二. 编写一个HTML Form 将订单的一些相关信息POST到paypal的页面上去.

 

View Code

 1  < form  id ="PayForm"  method ="post"  action ="https://www.sandbox.paypal.com/cgi-bin/webscr" >
 2 
 3  < input  type ="hidden"  name ="cmd"  value ="_xclick" />
 4 
 5  < input  type ="hidden"  name ="business"  value ="[email protected]" />
 6 
 7  < input  type ="hidden"  name ="item_name"  value ="OP0000055" />
 8 
 9  < input  type ="hidden"  name ="amount"  value ="480.00" />
10 
11  < input  type ="hidden"  name ="rm"  value ="2" />
12 
13  < input  type ="hidden"  name ="currency_code"  value ="HKD" />
14 
15  < input  type ="hidden"  name ="on0"  value ="ProductID" />
16 
17  < input  type ="hidden"  name ="os0"  value ="OP0000055" />
18 
19  </ form >

 

学习过HTML的同学都会知道上面是什么意思,以下是我对上面的一些参数含义的解释，如果你需要更多的帮助，你可以阅读Paypal集成指南的相关章节:

1.       请将form的method设置成POST 将action设置成https://www.sandbox.paypal.com/cgi-bin/webscr

如果要变成正式付款请将它设置成:

http://www.paypal.com/cgi-bin/webscr

2.       business设置成Paypal提供给你的账号,如果是正式环境发布，就需要用正式的账号

3.       amout设置成你要付款的金额

4.       item_name设置成你要付款的订单号

5. paypal提供了在Form裏面設置IPN(Instant Payment Notification 即时付款通知)的方法,只要你將下面的代碼加入Form中就可以設置

                   <input type=\"hidden\" name=\"notify_url\" value=”http://www.youdomain/PaypalIPN.aspx”/>,但本次開發中沒有使用這一種方法,我們會在paypal的business帳號的管理界面中設置好,下面的內容會介紹.

設置好這一些參數後，如果提交上去,就會實現這一個功能:將金額為:480.00訂單號為: OP0000055的訂單付款,收款方為[email protected](business帳號)

 (如果你要更详细的参数设置介绍，你可以查看Paypal集成文档在这里我并不贴出Order系统的其它的代码,我们只要将这个Form的代码生成好，动态替换里面要改变的参数(比如amout,orderref等)提交上去就好了,就比如说，一个页面上可以放两个Form,一个Form用于显示购物车里面的信息,另一个Form就可以放以上的代码,只要保证第二个Form提交了就OK了，悄悄的告诉你,我就是用StringBuilder这样一条一条append上去的，遇到要替换的参数我就Replace一下,我相信你一定知道我是怎么做的，哈哈,你信不信不要紧，反正我相信了!

 

 

当你将该Form提交后，你可以看到Order系统已跳转到sandbox.paypal.com的测试付款页面了

 

 

在這裏你就可以輸入你註冊的personal的帳號與密碼付款.

当你点击PayNow按钮时,Paypal就会开始给你做付款操作.

 

三 提供一个页面(paypalIPN.aspx)用于让Paypal更新我们的Order系统

 

我们先来看看IPN文档上怎么定义IPN的含义:

在买家通过您的网站付款结束后，PayPal 将异步（即不作为网站付款流程的一部分） 发送付款详细数据到您所指定的 URL，以便您了解买家付款的具体情况并做出相应的响应。 这个过程我们称作即时付款通知 (简称 IPN)。示意图如下：

 

1) 客户点击“付款”按钮向您的账户付款；

2) PayPal 接受到客户的付款后，向您的服务器指定的 URL 通过 POST 方式发送

IPN；

3) 在您的服务器收到 IPN 之后，您必须将收到的 POST 信息对原样返回给 PayPal 进行验证，PayPal 通过此方法帮您防范欺骗或“中间人”攻击；（对 IPN 信息 的验证过程我们称之为通知确认，详细的可参见 6.3）

4) PayPal 返回验证信息，通过验证为 VERIFIED，不通过则为 INVALD；

5) 根据验证信息处理付款明细。

【注】每次付款您可能收到多个 IPN 信息，一般来说直到收到 IPN 信息中的付款状态 为 Completed 为止。

IPN 数据包含了整个付款过程的详细信息，通过获取并分析它您可以：

„ 自定义网站对客户购物进行实时回复：您可以以 EMAIL 或其他方式通知客户 付款的状态；

„ 自动履行相关操作：当收到 IPN 数据并确认付款状态已经完成后，您就可以 立刻启动向买家发货的流程，也可以为买家进行虚拟货币的充值或者以某种方 式将虚拟商品的卡号和密码发送给买家；

„ 记录交易信息到您的数据库中。

 

 

当Paypal在做付款操作时,paypal会将本次付款的信息(如交易号,付款状态等)Post回Order系统,以便Order系统更新自己的系统,比如说更新订单的交易号与交易日期, 所以我们要提供一个页面来接收这一些数据,这个页面在Paypal里面叫IPN(Instant Payment Notification 即时付款通知)页面,(这个页面我们取名为paypalIPN.aspx)如果你想了解更多IPN的知识，请阅读即時付款通知指南

 

IPN可以在Form裏面設置也可以在Business帳號的管理頁面配置：

上sandbox裏選擇business帳號,然後點擊入business的帳號管理頁面

點用用戶信息-更多選項

               

就會進入如下頁面:

 

更改即時付款通知習慣設定

在通告Url中填入IPN的頁面地址(需要可以在外網訪問的地址):

選擇接收即時付款通知消息(已啟用),然後按保存.

 

paypalIPN.aspx的后台代码如下:

 

View Code

 1    private   void  Page_Load( object  sender, System.EventArgs e)
 2 
 3             {
 4 
 5                   //  Put user code to initialize the page here
 6 
 7                  Response.Write( " 200 OK " );
 8 
 9   
10 
11                   string  strResponse = ValidatePaypalInfo();
12 
13                   if (strResponse == " VERIFIED " )
14 
15                  {
16 
17                        string  pay_status = Request.Form[ " payment_status " ].ToString();
18 
19                        if (pay_status == " Completed " )
20 
21                       {
22 
23                              string  payID = Request.Form[ " txn_id " ].ToString();
24 
25  // 獲取交易號
26 
27                              string  orderID = Request.Form[ " item_name " ].ToString();
28 
29                              // 獲取訂單號
30 
31                             OrderProvider provider = new  OrderProvider();
32 
33                             service.SetOrderIsPay(payID,orderID);
34 
35                       }
36 
37                  }
38 
39   
40 
41             }
42 
43   
44 
45              private   string  ValidatePaypalInfo()
46 
47             {
48 
49                   string  strFormValues;
50 
51                   string  strNewValues;
52 
53                   string  strResponse;
54 
55                  HttpWebRequest req = (HttpWebRequest)WebRequest.Create(PayPaypal.FormPostAddress);
56 
57                  req.Method = " POST " ;
58 
59                  req.ContentType = " application/x-www-form-urlencoded " ;
60 
61                   byte [] param = HttpContext.Current.Request.BinaryRead(HttpContext.Current.Request.ContentLength);
62 
63                  strFormValues = Encoding.ASCII.GetString(param);
64 
65                  strNewValues = strFormValues + " &cmd=_notify-validate " ;
66 
67                  req.ContentLength = strNewValues.Length;
68 
69   
70 
71                  StreamWriter stout = new  StreamWriter(req.GetRequestStream(),Encoding.ASCII);
72 
73                  stout.Write(strNewValues);
74 
75                  stout.Close();
76 
77   
78 
79                  StreamReader sr = new  StreamReader(req.GetResponse().GetResponseStream());
80 
81                  strResponse = sr.ReadToEnd();
82 
83                  sr.Close();
84 
85                   return  strResponse;
86 
87             }

 

     代碼主要是接收https://www.sandbox.paypal.com/cgi-bin/webscr的返回值是否為VERIFIED,如果為true就可以用Request.form去獲取paypal返回的數據去更新Order系統,如果你想了解更多，請詳細閱讀即時付款通知指南

个人体会:

1.我个人认为,paypal要求我们提供的IPN页面只能用于更新Order系统,不应该用于显示界面(包括付款结果),不要將IPN頁面和Order系統付款結果頁面混為一談(IPN頁面只是用來更新系統，不用於顯示,而付款結果頁面只是用於顯示付款結果).

2.Order系统提供的IPN页面,是一定要有外网上可以访问的,要不然会造成返回参数接收不成功!我曾经在这个地方卡住很久,后来换成外网地址后就可以接收返回参数.

 

 

四 返回到Order系统的提示页面

当paypal付款成功后，我们会一直停留在paypal的付款完成页面,如果我们想要他自动返回我们的Order系统的某个页面,以显示出付款结果(或有其它的操作),我们就要用使用PDT，我们先来看一下实时付款通知文档里面PDT的意义是什么:

PDT 是一个安全获取付款明细的方式。在买家付完款后，卖家可以通过此方式即时获取付款明细并显示给买家看。PDT 的流程示意图如下所示：

 

 

1) 买家通过 PayPal 付款后根据事先设定的返回 URL(return)返回到您的网站；

2) PayPal 将在返回的 URL 附加变量 tx，即 PayPal 的交易流水号；

3) 将收到的交易流水号 tx 和您的身份标记通过 POST 方式发回给 PayPal；

4) PayPal 接受请求后验证身份标记及交易流水号后将付款明细发送回给网站；

5) 将接受到的付款明细处理后显示在买家的网页浏览器中。

Paypal的付款结果页面比paydollar的相对来说更复杂,我们首先要到你注册的business账号的管理页面去设置一下PDT

 

 

进入网站付款习惯设定

 

 

将自动返回设置成开启

将返回URL设置成你想要返回的页面地址

将付款数据传输设置为开启

请记录下你的身份标记,在以后的开发时用得上.

 

假定我们设置的PDT页面为:paypalResult.aspx,那么后台代码和IPN页面的代码很相似:

 

View Code

 1  protected  System.Web.UI.WebControls.Label lab_message;
 2 
 3           private   void  Page_Load( object  sender, System.EventArgs e)
 4 
 5          {
 6 
 7               string  result = GetPaypalPDTString();
 8 
 9               switch (result)
10 
11              {
12 
13                   case   " SUCCESS " :
14 
15                      lab_message.Text = PayResultConst.PAY_SUCCESS_MESSAGE;
16 
17                       break ;
18 
19                   case   "" :
20 
21                      lab_message.Text = PayResultConst.PAY_FAIL_MESSAGE;
22 
23                       break ;
24 
25                   default :
26 
27                      lab_message.Text = PayResultConst.PAY_ORTHER_ERROR_MESSAGE;
28 
29                       break ;
30 
31              }
32 
33          }
34 
35   
36 
37           private   string  GetPaypalPDTString()
38 
39          {
40 
41               string  strFormValues;
42 
43               string  strNewValues;
44 
45               string  strResponse;
46 
47               string  txToken = Request.QueryString[ " tx " ].ToString();
48 
49               string  query = " cmd=_notify-synch&tx= "   +  txToken  +   " &at= "   +  PayPaypal.PDTToken;
50 
51               // 请注意,请将PayPaypal.PDTToken设置为上文中你记录下来的身份标记
52 
53              HttpWebRequest req = (HttpWebRequest)WebRequest.Create(PayPaypal.FormPostAddress);
54 
55              req.Method = " POST " ;
56 
57              req.ContentType = " application/x-www-form-urlencoded " ;
58 
59               byte [] param = HttpContext.Current.Request.BinaryRead(HttpContext.Current.Request.ContentLength);
60 
61              strFormValues = Encoding.ASCII.GetString(param);
62 
63              strNewValues = strFormValues + query;
64 
65               // query附加上去一起发送给paypal
66 
67              req.ContentLength = strNewValues.Length;
68 
69   
70 
71              StreamWriter stout = new  StreamWriter(req.GetRequestStream(),Encoding.ASCII);
72 
73              stout.Write(strNewValues);
74 
75              stout.Close();
76 
77   
78 
79              StreamReader sr = new  StreamReader(req.GetResponse().GetResponseStream());
80 
81              strResponse = sr.ReadToEnd();
82 
83              sr.Close();
84 
85               return  strResponse.Substring( 0 ,strResponse.IndexOf( " \n " ));
86 
87       }
88 
89   

当系统开发完成后，你的公司可能会向Paypal申请正式的账号,这时你需要将Form的一些测试信息更改成正式信息(比如说action地址,business账号等等)