当前位置: 主页 > 日志 > PHP >

PayPal IPN接口集成经验分享

如果你的系统需要得知PayPal支付的最终结果(成功、失败),那么PayPal的IPN接口是最简单的解决方案。

 
IPN通知示意图
 
 
下面分享一下我的经验:
 
1)如何申请PayPal IPN接口?
 
你只需要拥有一个普通的PayPal账户即可,IPN接口不需要单独申请开通。
 
 
2)准备工作:申请一个沙盒账户。
 
在系统开发阶段,我们不需要用真实的PayPal账户来测试。
到https://developer.paypal.com注册一个开发人员账户(免费)。
登录系统,添加一个虚拟卖家(例如,seller_1316102076_biz@qq.com)和一个买家(例如,buyer_1316102290_per@qq.com)。
 
3)制作一个订单表单。
 
如下:
<form action="https://www.sandbox.paypal.com/cgi-bin/websc" method="post">
  <input type="hidden" name="business" value="seller_1316102076_biz@qq.com">
  <input type="hidden" name="item_name" value="海底捞优惠券">
  <input type="hidden" name="amount" value="30">
  <input type="hidden" name="no_note" value="1">
  <input type="hidden" name="return"  value="http://adsl.redicecn.com/order.php?status=ok">
  <input type="hidden" name="cancel_return" value="http://adsl.redicecn.com/">
  <input type="hidden" name="custom" value="1">
  <input type="hidden" name="notify_url" value="http://adsl.redicecn.com/ipn.php">
  
  <input type="hidden" name="cmd" value="_xclick">
  <input type="hidden" name="currency_code" value="CAD">
  <input type="hidden" name="charset" value="utf-8" />
  <input type="hidden" name="rm" value="1" />
 <input type="submit" value="支付" />
  </form>
 
解释一下几个重要的参数:
 
business = 收款者的PayPal账户
cmd = 立即购买按钮(_xclick),PayPal 购物车(_cart)
return = 支付成功后跳转地址
cancel_return = 取消支付后跳转地址
notify_url = 接收通知的接口(在第4部中我们实现该接口)
rm = PayPal跳转到return和cancel_return时的方式 (1=get, 2=post)
currency_code = 货币单位(美元-USD,加币-CAD)
 
item_name = 商品的描述信息
amount = 商品的总额
custom = 自定义值(可以存放订单编号,PayPal的通知消息中将包含该参数)。
charset = 指定参数采用的字符编码(设置不正确在PayPal账单上将显示乱码,特别是商品描述。)
 
关于这些参数的更详细说明请参考这里:http://paypal.ebay.cn/integrationcenter/list__center_2.html 。
另外需要注意的是,用沙盒账户测试时表单提交的地址用https://www.sandbox.paypal.com/cgi-bin/websc,正式使用时用https://www.paypal.com/cgi-bin/webscr。
 
 
4)写一个通知接口,用于接收PayPal返回的消息(判断支付状态)。
各个版本的接口实例这里都有,https://cms.paypal.com/ca/cgi-bin/?&cmd=_render-content&content_ID=developer/library_code_ipn_code_samples
 
下面是一个PHP的例子:
ipn.php
<?

// read the post from PayPal system and add 'cmd'
$req = 'cmd=_notify-validate';

foreach ($_POST as $key => $value) {
$value = urlencode(stripslashes($value));
$req .= "&$key=$value";
}

// post back to PayPal system to validate
$header .= "POST /cgi-bin/webscr HTTP/1.0\r\n";
$header .= "Content-Type: application/x-www-form-urlencoded\r\n";
$header .= "Content-Length: " . strlen($req) . "\r\n\r\n";

$fp = fsockopen ('ssl://www.sandbox.paypal.com', 443, $errno, $errstr, 30); // 沙盒用
//$fp = fsockopen ('ssl://www.paypal.com', 443, $errno, $errstr, 30); // 正式用

// assign posted variables to local variables
$item_name = $_POST['item_name'];
$item_number = $_POST['item_number'];
$payment_status = $_POST['payment_status'];
$payment_amount = $_POST['mc_gross'];
$payment_currency = $_POST['mc_currency'];
$txn_id = $_POST['txn_id'];
$receiver_email = $_POST['receiver_email'];
$payer_email = $_POST['payer_email'];
$mc_gross = $_POST['mc_gross ']; // 付款金额
$custom = $_POST['custom ']; // 得到订单号

if (!$fp) {
// HTTP ERROR
} else {
fputs ($fp, $header . $req);
while (!feof($fp)) {
$res = fgets ($fp, 1024);
if (strcmp ($res, "VERIFIED") == 0) {
// check the payment_status is Completed
// check that txn_id has not been previously processed
// check that receiver_email is your Primary PayPal email
// check that payment_amount/payment_currency are correct
// process payment
// 验证通过。付款成功了,在这里进行逻辑处理(修改订单状态,邮件提醒,自动发货等)
}
else if (strcmp ($res, "INVALID") == 0) {
// log for manual investigation
// 验证失败,可以不处理。
}
}
fclose ($fp);
}
?>
 
5)安全性的考虑:
 
A)如何防止客户修改购物表单里面的参数(特别是amount)。
在ipn.php中,判断付款金额$mc_gross是否与订单所需支付金额一致(根据订单号查数据库)。
 
B)有没有可能客户通过直接给ipn.php提交数据,绕过支付?
不可能。在ipn.php的一开始就对接收到的数据进行了校验(将接收到的数据原样发给PayPal验证,只有当PayPal检查认为是它自己发出的数据时才会返回"VERIFIED",否则返回"INVALID")。
 
给出几个截图,展示整个支付过程:
 
 第一步:
 
 第二步:
 
第三步:
 
第四步:
 
 
 
参考:
http://www.web-development-blog.com/archives/easy-payments-using-paypal-ipn/

 

[日志信息]

该日志于 2011-09-17 02:55 由 redice 发表在 redice's Blog ,你除了可以发表评论外,还可以转载 “PayPal IPN接口集成经验分享” 日志到你的网站或博客,但是请保留源地址及作者信息,谢谢!!    (尊重他人劳动,你我共同努力)
   
验证(必填):   点击我更换验证码

redice's Blog  is powered by DedeCms |  Theme by Monkeii.Lee |  网站地图 |  本服务器由西安鲲之鹏网络信息技术有限公司友情提供

返回顶部