zoukankan      html  css  js  c++  java
  • 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>



          如果使用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 
  • 相关阅读:
    4章假设检验
    参数估计
    3 抽样分布
    2.描述性统计的matlab 实现
    《做时间的朋友》第五章 小心所谓成功学
    《把时间当作朋友》第四章 开拓我们的心智
    《把时间当作朋友》第三章 提高心智,和时间做朋友
    《把时间当作朋友》第二章 开启自己的心智
    《把时间当作朋友》第1章 心智的力量
    《把时间当作朋友》1
  • 原文地址:https://www.cnblogs.com/wangpei/p/1429930.html
Copyright © 2011-2022 走看看