PayPal IPN接口集成经验分享

最新推荐文章于 2024-08-26 09:09:55 发布

hyjzcy

最新推荐文章于 2024-08-26 09:09:55 发布

阅读量1.4k

点赞数

付款接口开发专栏收录该内容

3 篇文章 0 订阅

订阅专栏

如果你的系统需要得知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）制作一个订单表单。

如下：

view plain copy to clipboard print ?

<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

view plain copy to clipboard print ?

<?
// 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);
}
?>