Paypal开发接口返回参数.doc

paypal支付开发接口 一点必须了解的基础知识：IPN的原理很简单，就是当产生了一个交易之后，交易状态发生变化时，如用户已经付款、或者退款、撤销时，Paypal利用常用的HTTP POST方式，将交易的一些变量提交给网站的某个页面（称之为IPN Handler），当这个页面接受到请求时候，将这些数据原封不动加上一个指示验证的cmd=_notify-validate，POST回Paypal的接口地址，如果数据正确，那么Paypal返回字符串VERIFIED，否则为INVALID，如果结果为VERIFIED，那么你的程序就可以使用这些数据进行操作。但代码的调试是一件很痛苦的事情，因为作为第三方开发人员，不可能开两个帐号，每次测试还要之间交易一些钱，所以Paypal专门开发了Sandbox给开发人员进行开发，首先到/ 注册一个开发帐号，好了之后再进入Sandbox建立测试用的Paypal虚拟帐号（至少应该建立一个Business的和一个Personal的），这种账号注册方法和Paypal的流程一样，信息可以是假的，包括银行帐号、信用卡（其实Paypal Sandbox会自动生成一些随机的号码）。接下来需要激活Paypal Sandbox的虚拟帐号，注意，这里不管你在Paypal Sanbox注册时填什么邮件地址，有任何发送到虚拟帐号所填邮箱的邮件都存会在开发帐号的管理界面中的Email页（导航栏上有）中。登录Sandbox的虚拟Paypal环境，还需要验证虚拟帐号的银行，这里可以随便填，然后通过Add Funds来给账户充值（想填多少填多少）关于IPN的详细设置登录至Paypal后台，进入My AccountProfile页面，点击Instant Payment Notification，如下图： 然后就会出现下面的页面了，点击Edit按钮，如下图： 然后就会出现下面的页面了，在页面里面那个选框处打勾，并在下面的Notification URL 处填写：http:/您的网站地址/index.php?gOo=cGF5cGFsX3JlcGx5LnBocA& 然后点击Save按钮，如下图：然后页面就会提示你：“You have successfully activated Instant Payment Notification.”接下来再次进入My AccountProfile页面，点击Website Payment Preferences ，如下图： 然后就会进入Website Payment Preferences页面，在里面要做四件事情：1：Auto Return 后面打勾选择On2：Return URL 后面输入：http:/您的网站地址/index.php?gOo=cGF5cGFsX3JlcGx5X3JldHVybi5waHA&3：Payment Data Transfer 后面打勾选择On4：上面都做好之后，点击页面最下面的Save按钮如下图：保存之后页面立即跳转到My AccountProfile，并且提示您设置成功，里面还会有一串identity token号码，那个就是私钥，如下图：当然，这个私钥（identity token）不会只出现这一次的，在您设置完之后，您可以仍然进入Website Payment Preferences页面去查看它，它就在Payment Data Transfer那一个区块，如下图：接下来，我们测试的时候，应该将Paypal接口的地址设置为/cgi-bin/webscr最后基本的流程为：用户在我们的网站上选择商品、放入购物车，然后检查准备支付网站根据购物车中的商品，生成Paypal的支付表单（也是提交到上面IPN用的Paypal接口地址），包含了此次交易的一些信息（下次会专门找机会解释一下）。并在自己的数据库中生成一张订单记录。Paypal在Session中记录下这些交易信息用户用Paypal账户登录Paypal（Sandbox用Sandbox的虚拟帐号），复查明细，点击Pay按钮Paypal进行交易处理，如果我们的Paypal收款帐号在接受帐款上没有什么问题（没有特别的需要Accept的地方），交易完成，那么Paypal会发送一个IPN，并发送提示邮件。我们IPN Handler接受到信息，首先向Paypal进行校验，如果信息正确，然后根据信息和自己数据库中进行比对，如果无误，可以将支付信息保存，并修改订单状态。然后Paypal会显示一个界面表示交易完成，此时如果用户点击“Return”按钮，Paypal会将用户送回我们网站指定地点。我们网站迎接用户回来，向用户表示感谢，并进行提醒，给出订单号等等。如果明文形式的话，就和压缩包里面的paypal.htm文件一般!-一次购买- 二次返回的参数成功标志SUCCESSfirst_name=%E8%80%81last_name=%E7%89%87 address_status=unconfirmed address_zip=100001 address_street： address_country=China address_country_code=CN address_name=%E7%89%87%E8%80%81 address_city=%E5%8C%97%E4%BA%ACaddress_state=%E5%8C%97%E4%BA%AC contact_phone=01058472654payer_email=jinold_2%40163.comtax=0.00 payer_id=T85NNQLW2BHJQ payment_date=22%3A35%3A00+Sep+09%2C+2006+PDT payment_status=Completed charset=UTF-8custom= payer_status=unverified business=jiangjun_0_1999%40163.com 商家账号receiver_email=jiangjun_0_1999%40163.com 商家帐户中注册的邮件txn_id=28267733YJ662041W 唯一贝宝交易号，和tx意义一样payment_type=instant receiver_id=8LFB8Q7WADTW4 txn_type=cart mc_currency=CNY residence_country=CN payment_gross=商品信息num_cart_items=3 商品种类mc_gross=3.00 总额mc_shipping=0.00 mc_handling=0.00 item_number1=1001 商品1的编号item_number2=1002 item_number3=1003item_name1=Java 商品1 的名称item_name2=C%2B%2B item_name3=Oracle quantity1=1 商品1的数量quantity2=1 quantity3=1mc