海外支付：遍布全球的Paypal
吴剑 2015-11-26
原创文章，转载必需注明出处：http://www.cnblogs.com/wu-jian
吴剑 http://www.cnblogs.com/wu-jian
前言
Paypal是全球在线支付的领导者，2002年被eBay收购，2015年又戏剧性的从eBay分离，以500亿美元市值反超eBay。创始人 Elon Musk 同时是Paypal、空间探索技术公司、以及特斯拉汽车三家公司的CEO，电影“钢铁侠”的人物原型就是这哥们。
吴剑 http://www.cnblogs.com/wu-jian
概述
Paypal为商家提供了多种支付对接方式，其中Paypal Express Checkout最为常见、方便、以及自定义扩展性最强。下图是Paypal Express Checkout支付的一个标准时序图，注意这是一个纯技术层面的API调用流程，在此基础上，我们可以组合出三种Paypal通用的用户支付体验：
快捷支付，直接去Paypal付款并使用Paypal上存储的地址发货。很明显，Paypal希望把自己打造成一个用户中心，也花了血本来推广这种方式，具我所知，该方式也是海外用户使用占比最高的。
标准支付，就像我们国内的天猫淘宝一样，填好了收件地址，完了再去支付。
游客支付，或称之为信用卡支付。当然信用卡不是Paypal强项，Paypal跟支付宝一样充当的是银行与用户之间的中间人角色。在信用卡领域，VISA是老大，同时信用卡涉及到相当高的安全层面风险，具体请参考我的另一篇文章 海外支付：抵御信用卡欺诈的CyberSource 。
这三种支付方式都是基于下图中相同API，只是组合序顺或传递的参数稍有差异而以。
<图1.Paypal Express Checkout API接口>
吴剑 http://www.cnblogs.com/wu-jian
SetExpressCheckout
这是一个同步的API接口，将交易相关的所有数据首先通过SetExpressCheckout传递给Paypal，然后Paypal响应一个Token用于后续支付步骤，Token有效时间为3小时。
从接口前缀Set可以看出该接口是一个预交易步骤，好比我们去银行提大额现金，需要提前一天给银行通知，一来有助于银行备齐现金，二来也有助于交易安全，银行有充分时间评估交易的可靠性。后来在架构多平台的支付中心时，我也参考和使用了Paypal的这个结构。
SetExpressCheckout的参数很多，具体可参见Paypal官方文档：https://developer.paypal.com/docs/classic/api/merchant/SetExpressCheckout_API_Operation_NVP/ ，下面列出一些常用参数：
| 参数名称 | 参数说明 |
|---|---|
| VERSION | 接口版本号 |
| METHOD | API名称，使用“SetExpressCheckout”即可 |
| REQCONFIRMSHIPPING | 商家是否需要买家在PayPal账户中的邮寄地址是已经被确认的地址 |
| PAYMENTREQUEST_{m}_PAYMENTACTION | 希望获取付款的方式 |
| ALLOWNOTE | 允许买方在PayPal结账页面上输入了一条文本信息给商家 |
| LOCALECODE | PayPal付款页面显示语言的设置 |
| RETURNURL | 客户选择通过PayPal付款后其浏览器将返回的URL |
| CANCELURL | 客户取消使用PayPal付款时返回的URL |
| 结账时输入的买家电子邮件。 PayPal使用该值预填PayPal登录页面的PayPal会员注册部分 | |
| PAYMENTREQUEST_{m}_CURRENCYCODE | PayPal支持的交易币种中所列币种之一的三字符币种代码 |
| PAYMENTREQUEST_{m}_AMT | 交易总费用 |
| PAYMENTREQUEST_{m}_ITEMAMT | 订单所有物品的价格 |
| PAYMENTREQUEST_{m}_SHIPPINGAMT | 邮费总额 |
| NOSHIPPING | 是否不在PayPal付款页面展示邮寄地址 |
| LANDINGPAGE | 付款页面展示类型 |
| SOLUTIONTYPE | 结账流程的类型 |
| HDRIMG | 付款页面左上角显示的图片的URL |
| HDRBACKCOLOR | 付款页面标题的背景色 |
| PAYFLOWCOLOR | 付款页面设置背景色 |
| HDRBORDERCOLOR | 付款页面标题边框颜色 |
| L_PAYMENTREQUEST_{m}_NUMBER{n} | 商品编号 |
| L_PAYMENTREQUEST_{m}_NAME{n} | 商品名称 |
| L_PAYMENTREQUEST_{m}_QTY{n} | 商品数量 |
| L_PAYMENTREQUEST_{m}_AMT{n} | 商品单价 |
| PAYMENTREQUEST_{m}_INVNUM | 商家订单编号 |
吴剑 http://www.cnblogs.com/wu-jian
GetExpressCheckoutDetails
如图1所示，在通过SetExpressCheckout接口获取到Token后，就需要跳转页面去Paypal了。用户在Paypal站点登录，确认支付信息，完成支付，最后Paypal将URL重定向回商家页面。
此时，我们可以获取用户在Paypal的相关信息。接口的详细参数可参见Paypal官方文档：https://developer.paypal.com/docs/classic/api/merchant/GetExpressCheckoutDetails_API_Operation_NVP/ ，下面列出常用的响应参数：
| 参数名称 | 参数说明 |
|---|---|
| TOKEN | Token |
| PAYERID | Paypal用户ID |
| Paypal账号(Email) | |
| PAYMENTREQUEST_{n}_SHIPTONAME | 货运地址姓名 |
| PHONENUM | 货运地址电话 |
| PAYMENTREQUEST_{n}_SHIPTOCOUNTRYCODE | 货运地址国家ID |
| PAYMENTREQUEST_{n}_SHIPTOSTATE | 货运地址省份 |
| PAYMENTREQUEST_{n}_SHIPTOCITY | 货运地址城市 |
| PAYMENTREQUEST_{n}_SHIPTOZIP | 货运地址邮编 |
| PAYMENTREQUEST_{n}_SHIPTOSTREET | 货运地址街道1 |
| PAYMENTREQUEST_{n}_SHIPTOSTREET2 | 货运地址街道2 |
在此需要提一下的是，Paypal的接口非常灵活，它最大限度让商家可以使用相同的API来组合不同的支付逻辑以提高用户体验。比如在标准支付时，用户在商家网站填写并存储了邮寄地址，因此邮寄地址不需要与Paypal交互；而在快捷支付时，则可以通过GetExpressCheckoutDetails接口获取用户存储在Paypal上的地址信息并且在商家页面上显示给用户确认。
吴剑 http://www.cnblogs.com/wu-jian
DoExpressCheckoutDetails
DoExpressCheckoutDetails是Paypal实时交易的最后一步，它告诉并向Paypal确认最终的支付信息，当完成对它的调用，就代表了Paypal实时支付的完成，也代表Money从用户账户到了商家账户。详细官方API文档请参考：https://developer.paypal.com/webapps/developer/docs/classic/api/merchant/DoExpressCheckoutPayment_API_Operation_NVP/ ，如下列出了接口响应结果：
| 参数名称 | 参数说明 |
|---|---|
| PAYMENTINFO_{n}_PAYMENTSTATUS | 付款结果状态 |
| PAYMENTINFO_{n}_CURRENCYCODE | 成功币种 |
| PAYMENTINFO_{n}_AMT | 成功金额 |
| PAYMENTINFO_{n}_TRANSACTIONID | Paypal交易ID |
在快捷支付时，因为用户的邮寄地址存放在Paypal中，因此在GetExpressCheckoutDetails前，我们无法知道用户是哪个国家，也就不能计算出运费金额。所以通常在快捷支付时，我们会在GetExpressCheckoutDetails中获取用户邮寄地址来计算运费，在DoExpressCheckoutDetails中更新运费并确认最终金额。
吴剑 http://www.cnblogs.com/wu-jian
异步IPN通知
IPN全称为 Instant Payment Notification，在每笔交易完成后，Paypal可提供通知服务，即商家提供一个URL，Paypal向这个URL发送交易结果。这个过程是异步的，比如因为网络繁忙或你的服务器故障，IPN会在连续4天内最大15次持续发送结果，直到你收到为止。Paypal不建议在实时的支付流程中使用IPN，但我们可以使用IPN作为交易安全辅助或交易提醒等用途。
IPN开发概要：https://developer.paypal.com/webapps/developer/docs/classic/ipn/integration-guide/IPNIntro/
IPN详细参数：https://developer.paypal.com/docs/classic/ipn/integration-guide/IPNandPDTVariables/
在Paypal商户后台中开启IPN：用户信息 -> 即时付款通知
IPN基于HTTP的POST规范，当成功接收到IPN结果后响应HTTP 200即可：
附录：Paypal商户后台API设置截图
吴剑 http://www.cnblogs.com/wu-jian
结束语
本文对Paypal支付流程和API进行了概要性描述，并未涉及到具体代码细节，有了清晰的思路再编码是事半功倍的事，希望对从业的开发人员有所帮助。也希望中国的产品有朝一日不再是廉价和仿冒的代名词，希望中国的海外卖家能把我们的创新展现给世界人民，希望更多的站点能够崛起和打破阿里的垄断。
最后友情提示，在海外大多数国家，对侵权的打击还是相当严厉的。Paypal是一家美国公司，遵守的是美国司法体系，如果你的站点销售侵权产品，通常Paypal会给你警告，据我所知他们也有专门的巡查部门。但如果一旦你被海外用户取证和诉讼并且事实成立，你的资金就有可能被Paypal冻结。
吴剑 http://www.cnblogs.com/wu-jian
<全文完>
吴剑 http://www.cnblogs.com/wu-jian
作者：吴剑
出处：http://www.cnblogs.com/wu-jian/
本文版权归作者所有，欢迎转载，但必需注明出处，并且在转载页面明显位置给出原文连接，否则保留追究法律责任的权利。
