Paypal国际版网站集成简易教程

转自：http://www.chenchen.org/article/paypal/4.htm

Paypal国际版网站集成简易教程（一）：序言

      前段时间接到一个外贸网站的项目，集成paypal支付接口的，对象是海外用户，全部用US的信用卡结算。国内有个paypal的中文版，叫贝宝，不过只支持人民币之间的结算，而且提供的功能不多。所以只能使用paypal国际版，也就是paypal.com，习惯性的google了一下相关资料，发现关于paypal.com接口的中文文档并不多，也不详细，只好自己上paypal.com研究，还好paypal上的资料非常齐全，而且还提供了开发者沙盒（sandbox），相比之下，国内流行的支付宝还有很长的路要走啊。
    
      项目结束的时候就有想法写一篇网站集成paypal的简易教程，方便以后的各位开发者，毕竟看长篇英文资料是很头痛的事情^_^。一直到昨天期末考才结束，所以今天开始写这个教程，其实内容也不多，可能还算不上教程，只能算经验吧。

      主要分为序言、支付按钮、返回信息方式（IPN&PDT）、实例四部分组成，预计在三天内完成，如果有新内容我临时再加吧。
    
      接下来一篇将会介绍如何在网站上快速加入paypal支付按钮。

 

Paypal国际版网站集成简易教程（二）：快速加入支付按钮

      本篇主要介绍如何在你的网站上快速加入paypal支付按钮，通过这个按钮，人们可以方便快速的付款到你的paypal帐户。
      首先，你需要注册一个paypal帐户，帐户类型分为Personal（个人）、Premier（高级）和Business（商业），他们的差别对于开发者来说主要是返回的信息，Personal的不能使用IPN和PDT等商家工具，即不能获取交易信息，但是Personal帐户收款无需手续费；Premier和Business当然就提供了IPN和PDT功能，能够在客户支付成功后，将交易信息传给指定的网站，用来二次使用。Premier和Business使用上的差异我不是很清楚，应该是月收款额和手续费上的区别吧。
      这里插进来介绍一下paypal sandbox，也就是沙盒，是paypal提供给开发者的一个工具，非常好用，你可以在https://developer.paypal.com/注册和使用它。登录以后可以新建帐户，设置余额和帐户类型，有一点要注意，每次使用时必须先登录sandbox才能使用新建的那些帐户。Sndbox里面有个测试工具，可以发送IPN的，以后会用到。

      接着上面的内容，注册完帐户以后，当然，一开始开发最好使用sandbox，不然资金转来转去手续费都扣光了，paypal的费率如下：
      
      比起国内的支付工具，paypal贵了好多，当然，和国情也有关系。
    
      接下来是按钮的代码，很简单，就是一个普通的网页表单代码：
      

程序代码

< form  action ="https://www.paypal.com/cgi-bin/webscr"  method ="post" >
    < input  type ="hidden"  name ="cmd"  value ="_xclick" >
    < input  type ="hidden"  name ="business"  value ="sample@sample.com" >
    < input  type ="hidden"  name ="item_name"  
   value ="Item Name Goes Here" >
    < input  type ="hidden"  name ="item_number"  
   value ="Item Number Goes Here" >
    < input  type ="hidden"  name ="amount"  value ="100.00" >
    < input  type ="hidden"  name ="no_shipping"  value ="2" >
    < input  type ="hidden"  name ="no_note"  value ="1" >
    < input  type ="hidden"  name ="currency_code"  value ="USD" >
    < input  type ="hidden"  name ="bn"  value ="IC_Sample" >
    < input  type ="image"  src ="https://www.paypal.com/
   en_US/i/btn/x-click-but23.gif"  
   name ="submit"  alt ="Make payments with payPal - it's fast, 
   free and secure!" >
    < img  alt =""  
   src ="https://www.paypal.com/en_US/i/scr/pixel.gif"  
   width ="1"  height ="1" >
</ form >

 

asp.net 版本：

aspx： <asp:ImageButton ID="submit" runat="server" OnClick="submit_onclick" ImageUrl="~/Flow/images/paypal.jpg" />

cs：

protected void submit_onclick (){
// 存储购物车的总额
decimal amount = Convert.ToDecimal(“280.00”);
// 存储订单ID
string orderId = “200810240101”;
// 获取网站的名称
string siteName = BalloonShopConfiguration.SiteName;
// 创建贝宝重定向的位置
string redirect = "";
redirect += "https://www.paypal.com/xclick/business=zmm12@126.com";
redirect += "&item_name=" + siteName + " Order " + orderId;
redirect += "&item_number=" + orderId;
redirect += "&amount=" + String.Format("{0:0.00} ", amount);
redirect += "&currency=USD";

redirect += "&return=http://www." + siteName + ".com/这里是成功后返回的aspx页面";
//如果失败回到的页面
redirect += "&cancel_return=http://www." + siteName + ".com/Error.aspx";


// 重定向到付款页面
Response.Redirect(redirect);
}

 

 

 

      如果使用sandbox，action地址改成https://www.sandbox.paypal.com/cgi-bin/webscr即可，上面这段还是很容易理解的，看下name和value基本上就能知道每个值的含义了。
      
      保存用浏览器打开，就会看到一个paypal的按钮，点击过去按照提示操作，就能付款到business指定值的帐户了。

      这就是一个最简单的paypal支付按钮。
      再下一篇中会讲一下如何在付款成功之后，将信息返回到你的网站，大部分需求都是客户完成付款后返回信息到网站的数据库，记录网站客服的交易信息。

      最后稍微了解下为什么海外用户喜欢用自己的网站做生意，而不是像国内一样用淘宝之类的C2C平台。一开始我也很不理解，有免费的平台为什么要自己建设网站还要支付paypal的手续费，后来和客户了解了一下，他们做的事网游虚拟交易，国外最大的C2C平台就是eBay，但只有德国可以售卖虚拟物品，并且eBay上的交易并不是免费的，收取的手续费远远高于paypal的费率，因此，更多的海外用户选择自己建设网站进行电子商务。

 

Paypal国际版网站集成简易教程（三）：IPN的使用

      本文内容采用知识共享署名-非商业性使用-禁止演绎 2.5 中国大陆许可协议进行许可。

      

引用内容

什么是即时付款通知IPN
当您收到新的付款交易或者已发生的付款交易的状态发生变化时，PayPal都将异步（即不作为网站付款流程的一部分） 发送付款详细数据到您所指定的URL，以便您了解买家付款的具体情况并做出相应的响应。这个过程我们称作即时付款通知（简称 IPN）。

      最近事情比较多，一直没有继续更新，不好意思了，今天难得有空，就把最重要的一段先发上来了。

      相信大部分网站集成Paypal都希望能够实现客户支付完成后返回信息到自己的网站，然后处理这些信息。比如客户在你的网站上购买了一个产品，通过Paypal完成了支付，接着Paypal告诉你的网站客户完成了支付以及支付信息，最后你的网站将这些信息记录到你自己的数据库中，并且将你的客户订单状态设为已支付，接着你就可以进行一系列的相关订单的后续操作。
      IPN就能帮助我们实现这个功能，IPN示意图如下（来自Paypal.com）：
      

      当客户完成支付，Paypal会在后台通过post方式向你的服务器传送交易数据，来实现网站集成的功能。
接下来我们就来看IPN的实现方法。
      第一步，你需要一个sandbox的帐号，这很重要，因为它能让你随心所欲的进行测试，而不用担心资金在天上飞。注册地址：https://developer.paypal.com/
      第二步，登陆sandbox，新建一个商家帐号（卖方）和一个客户账号（买方），其中卖方帐号必须是Premier或者Business，不然无法使用IPN功能。
      

      新建买家帐号的时候记得在Account Balance中加上金额，不然你就没钱买东西了，如果paypal.com的帐号也能这样加钱多好。
      新建完两个帐号：
      

      卖家帐号的test mode要设为enabled。
      选中business帐号，点击下面的Enter Sandbox Test Site进入sandbox Test Site，登录，就像普通Paypal帐号的管理页面一样。
      

      点击Profile，在Selling Preferences中选择Instant Payment Notification Preferences，点击edit加入IPN信息返回的地址，记得勾上前面那个选项，我是用.net写的接受文件，所以我的IPN地址是http://www.chenchen.org/ipn.aspx,地址只要能在互联网上访问到就可以了。
      

      在Profile -> Selling Preferences ->Website Payment Preferences选项中，有一个Auto Return的选项，将它设为on，并且在下面的return地址中填入你希望的客户支付完成后返回的地址：
      

       以上就完成了商家端的设置。

      接下来是你网站上ipn.aspx文件的编写，这个是用来接收支付数据的，是非常关键的一个文件。
      文件环境，.net 2.0，语言C#。
      Ipn.aspx文件：此文件不用修改任何东西，代码都在cs文件中。
      Ipn.aspx.cs文件：关键代码

      定义一个VerifyIPN()函数：

程序代码

bool  VerifyIPN()
{
         string  strFormValues  =  Request.Form.ToString();
         string  strNewValue;
         string  strResponse;
         string  serverURL  =   " https://www.sandbox.paypal.com/cgi-bin/webscr " ;

        HttpWebRequest req  =  (HttpWebRequest)WebRequest.Create(serverURL);
        req.Method  =   " POST " ;
        req.ContentType  =   " application/x-www-form-urlencoded " ;
        strNewValue  =  strFormValues  +   " &cmd=_notify-validate " ;
        req.ContentLength  =  strNewValue.Length;

        StreamWriter stOut  =   new  StreamWriter(req.GetRequestStream(), System.Text.Encoding.ASCII);
        stOut.Write(strNewValue);
        stOut.Close();

        StreamReader stIn  =   new  StreamReader(req.GetResponse().GetResponseStream());
        strResponse  =  stIn.ReadToEnd();
        stIn.Close();

         return  strResponse  ==   " VERIFIED " ;
}

       这段代码的作用是判断IPN信息是否来自Pyapal，如果不进行判断，那么恶意用户完全可以模拟一个信息post到你的网站上，让你认为订单已经完成支付，所以，必须首先对接受到的信息进行验证。

      代码的基本原理，serverURL定义了验证地址，sandbox为：https://www.sandbox.paypal.com/cgi-bin/webscr，Paypal.com就是https://www.paypal.com/cgi-bin/webscr。
      将paypal发送过来的所有信息加上一个&cmd=_notify-validate参数，表示对这个信息进行验证，全部发送回paypal验证，如果信息确实存在，则返回VERIFIED字符串。
验证成功后，就可以用如下形式获得交易信息：

程序代码

string  ppTx  =  Request.Form[ " txn_id " ].ToString();
string  ppStatus  =  Request.Form[ " payment_status " ].ToString();
string  ppDate  =  Request.Form[ " payment_date " ].ToString();
string  ppItem  =  Request.Form[ " item_name " ].ToString();
string  ppPrice  =  Request.Form[ " mc_gross " ].ToString();

      每个变量的解释可以参考Paypal网站上的说明，我这里就不再重复。

     .cs代码结构如下：

程序代码

public   partial   class  paypal_ipn : System.Web.UI.Page
{
     protected   void  Page_Load( object  sender, EventArgs e)
    {
         if  (VerifyIPN()) // 验证成功
        {
             string  ppTx  =  Request.Form[ " txn_id " ].ToString(); // 获取post中的各项变量值
                …
            执行将数据写入数据库等操作
        }   
    }

     bool  VerifyIPN()
{
        具体代码见上。
    }
}

      这样，就实现了将支付信息传回网站的功能。注：当交易状态发生改变时，paypal也会返回一个ipn，比如完成支付，退款等等。

      介绍一下sandbox中IPN测试工具，登陆sandbox主帐号，就是你在sandbox上注册的那个，不是那些卖家/买家帐号。
      选择Test Tools -> Instant Payment Notification (IPN) Simulator：

      输入你的ipn接受文件地址，选择ipn信息的方式，然后会让你填具体信息内容，再点击Send IPN，就能模拟一个ipn到你网站的页面，可以用来测试IPN是否正常工作。
      
      
      不过这个工具有个小BUG，就是发送的IPN里不包括contact_phone这个变量，但是实际的IPN里是有的，这里要注意一下。
      注：可以在商家帐号的Profile -> Selling Preferences ->Website Payment Preferences中，选择Contact Telephone Number这一栏，来确定是否需要发送买家联系电话。
      

      通过IPN，你的网站就开始从真正意义上的集成了Paypal。
      这篇文章写得有些仓促，如有疑问可以发送邮件到：chenchen[at]ndwork.com  用@替换[at]。
      下一次我会讲PDT方式，这个比IPN简单很多。

Paypal国际版网站集成简易教程（四）：PDT的使用

引用内容

什么是PDT
PDT是一个安全获取付款明细的方式。在买家付完款后，卖家可以通过此方式即时获取付款明细并显示给买家看。

      暑假时候写了前面三篇文章，后来去电视台打工了，帮他们上了一个人居博览会，再接着就开学了，又在杭州、温州、宁波跑来跑去。一直不能静下来继续写，现在工作又没啥着落哈。
      今天难得有感觉想写了，不知道是不是中午牛排的威力，趁机会就快点写吧。

      

      上图是PDT的流程示意。
      1.首先买家付款后通过事先设定好的返回url（return）回到您的网站。
      2.接着paypal在返回url后面加上tx变量，即交易号。
      3.然后网站将收到的tx和您的令牌（paypal账户里申请）发回paypal。
      4.paypal验证令牌通过后，将交易明细发回网站。
      5.最后网站将交易明细显示给客户。

       启用PDT