海外支付：遍布全球的Paypal

阳光穿透心脏的1/2处 2021-12-12 02:25 430阅读 0赞

海外支付：遍布全球的Paypal

吴剑 2015-11-26

原创文章，转载必需注明出处：[http://www.cnblogs.com/wu-jian][http_www.cnblogs.com_wu-jian]

吴剑 http://www.cnblogs.com/wu-jian

前言

Paypal是全球在线支付的领导者，2002年被eBay收购，2015年又戏剧性的从eBay分离，以500亿美元市值反超eBay。创始人 Elon Musk 同时是Paypal、空间探索技术公司、以及特斯拉汽车三家公司的CEO，电影“钢铁侠”的人物原型就是这哥们。

![221208030295478.jpg][]

[海外支付：遍布全球的Paypal][Paypal]

[海外支付：抵御信用卡欺诈的CyberSource][CyberSource]

吴剑 http://www.cnblogs.com/wu-jian

概述

Paypal为商家提供了多种支付对接方式，其中Paypal Express Checkout最为常见、方便、以及自定义扩展性最强。下图是Paypal Express Checkout支付的一个标准时序图，注意这是一个纯技术层面的API调用流程，在此基础上，我们可以组合出三种Paypal通用的用户支付体验：

**快捷支付**，直接去Paypal付款并使用Paypal上存储的地址发货。很明显，Paypal希望把自己打造成一个用户中心，也花了血本来推广这种方式，具我所知，该方式也是海外用户使用占比最高的。

**标准支付**，就像我们国内的天猫淘宝一样，填好了收件地址，完了再去支付。

**游客支付**，或称之为信用卡支付。当然信用卡不是Paypal强项，Paypal跟支付宝一样充当的是银行与用户之间的中间人角色。在信用卡领域，VISA是老大，同时信用卡涉及到相当高的安全层面风险，具体请参考我的另一篇文章 [海外支付：抵御信用卡欺诈的CyberSource][CyberSource] 。

这三种支付方式都是基于下图中相同API，只是组合序顺或传递的参数稍有差异而以。

![171053055416598.jpg][]

<图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/][https_developer.paypal.com_docs_classic_api_merchant_SetExpressCheckout_API_Operation_NVP] ，下面列出一些常用参数：

<table> 
 <tbody> 
  <tr> 
   <th>参数名称</th> 
   <th>参数说明</th> 
  </tr> 
  <tr> 
   <td>VERSION</td> 
   <td>接口版本号</td> 
  </tr> 
  <tr> 
   <td>METHOD</td> 
   <td>API名称，使用“SetExpressCheckout”即可</td> 
  </tr> 
  <tr> 
   <td>REQCONFIRMSHIPPING</td> 
   <td>商家是否需要买家在PayPal账户中的邮寄地址是已经被确认的地址</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{m}_PAYMENTACTION</td> 
   <td>希望获取付款的方式</td> 
  </tr> 
  <tr> 
   <td>ALLOWNOTE</td> 
   <td>允许买方在PayPal结账页面上输入了一条文本信息给商家</td> 
  </tr> 
  <tr> 
   <td>LOCALECODE</td> 
   <td>PayPal付款页面显示语言的设置</td> 
  </tr> 
  <tr> 
   <td>RETURNURL</td> 
   <td>客户选择通过PayPal付款后其浏览器将返回的URL</td> 
  </tr> 
  <tr> 
   <td>CANCELURL</td> 
   <td>客户取消使用PayPal付款时返回的URL</td> 
  </tr> 
  <tr> 
   <td>EMAIL</td> 
   <td>结账时输入的买家电子邮件。 PayPal使用该值预填PayPal登录页面的PayPal会员注册部分</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{m}_CURRENCYCODE</td> 
   <td>PayPal支持的交易币种中所列币种之一的三字符币种代码</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{m}_AMT</td> 
   <td>交易总费用</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{m}_ITEMAMT</td> 
   <td>订单所有物品的价格</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{m}_SHIPPINGAMT</td> 
   <td>邮费总额</td> 
  </tr> 
  <tr> 
   <td>NOSHIPPING</td> 
   <td>是否不在PayPal付款页面展示邮寄地址</td> 
  </tr> 
  <tr> 
   <td>LANDINGPAGE</td> 
   <td>付款页面展示类型</td> 
  </tr> 
  <tr> 
   <td>SOLUTIONTYPE</td> 
   <td>结账流程的类型</td> 
  </tr> 
  <tr> 
   <td>HDRIMG</td> 
   <td>付款页面左上角显示的图片的URL</td> 
  </tr> 
  <tr> 
   <td>HDRBACKCOLOR</td> 
   <td>付款页面标题的背景色</td> 
  </tr> 
  <tr> 
   <td>PAYFLOWCOLOR</td> 
   <td>付款页面设置背景色</td> 
  </tr> 
  <tr> 
   <td>HDRBORDERCOLOR</td> 
   <td>付款页面标题边框颜色</td> 
  </tr> 
  <tr> 
   <td>L_PAYMENTREQUEST_{m}_NUMBER{n}</td> 
   <td>商品编号</td> 
  </tr> 
  <tr> 
   <td>L_PAYMENTREQUEST_{m}_NAME{n}</td> 
   <td>商品名称</td> 
  </tr> 
  <tr> 
   <td>L_PAYMENTREQUEST_{m}_QTY{n}</td> 
   <td>商品数量</td> 
  </tr> 
  <tr> 
   <td>L_PAYMENTREQUEST_{m}_AMT{n}</td> 
   <td>商品单价</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{m}_INVNUM</td> 
   <td>商家订单编号</td> 
  </tr> 
 </tbody> 
</table>

吴剑 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/][https_developer.paypal.com_docs_classic_api_merchant_GetExpressCheckoutDetails_API_Operation_NVP] ，下面列出常用的响应参数：

<table> 
 <tbody> 
  <tr> 
   <th>参数名称</th> 
   <th>参数说明</th> 
  </tr> 
  <tr> 
   <td>TOKEN</td> 
   <td>Token</td> 
  </tr> 
  <tr> 
   <td>PAYERID</td> 
   <td>Paypal用户ID</td> 
  </tr> 
  <tr> 
   <td>EMAIL</td> 
   <td>Paypal账号(Email)</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{n}_SHIPTONAME</td> 
   <td>货运地址姓名</td> 
  </tr> 
  <tr> 
   <td>PHONENUM</td> 
   <td>货运地址电话</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{n}_SHIPTOCOUNTRYCODE</td> 
   <td>货运地址国家ID</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{n}_SHIPTOSTATE</td> 
   <td>货运地址省份</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{n}_SHIPTOCITY</td> 
   <td>货运地址城市</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{n}_SHIPTOZIP</td> 
   <td>货运地址邮编</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{n}_SHIPTOSTREET</td> 
   <td>货运地址街道1</td> 
  </tr> 
  <tr> 
   <td>PAYMENTREQUEST_{n}_SHIPTOSTREET2</td> 
   <td>货运地址街道2</td> 
  </tr> 
 </tbody> 
</table>

在此需要提一下的是，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/][https_developer.paypal.com_webapps_developer_docs_classic_api_merchant_DoExpressCheckoutPayment_API_Operation_NVP] ，如下列出了接口响应结果：

<table> 
 <tbody> 
  <tr> 
   <th>参数名称</th> 
   <th>参数说明</th> 
  </tr> 
  <tr> 
   <td>PAYMENTINFO_{n}_PAYMENTSTATUS</td> 
   <td>付款结果状态</td> 
  </tr> 
  <tr> 
   <td>PAYMENTINFO_{n}_CURRENCYCODE</td> 
   <td>成功币种</td> 
  </tr> 
  <tr> 
   <td>PAYMENTINFO_{n}_AMT</td> 
   <td>成功金额</td> 
  </tr> 
  <tr> 
   <td>PAYMENTINFO_{n}_TRANSACTIONID</td> 
   <td>Paypal交易ID</td> 
  </tr> 
 </tbody> 
</table>

在快捷支付时，因为用户的邮寄地址存放在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/][https_developer.paypal.com_webapps_developer_docs_classic_ipn_integration-guide_IPNIntro]

IPN详细参数：[https://developer.paypal.com/docs/classic/ipn/integration-guide/IPNandPDTVariables/][https_developer.paypal.com_docs_classic_ipn_integration-guide_IPNandPDTVariables]

在Paypal商户后台中开启IPN：用户信息 -> 即时付款通知

![250919024204213.jpg][]

IPN基于HTTP的POST规范，当成功接收到IPN结果后响应HTTP 200即可：

![250945452958492.jpg][]

附录：Paypal商户后台API设置截图

![113726-20151126152903890-1794935097.jpg][]

![113726-20151126152915843-1321747795.jpg][]

![113726-20151126152928906-1566837317.jpg][]

![113726-20151126152938562-1544704979.jpg][]

吴剑 http://www.cnblogs.com/wu-jian

结束语

本文对Paypal支付流程和API进行了概要性描述，并未涉及到具体代码细节，有了清晰的思路再编码是事半功倍的事，希望对从业的开发人员有所帮助。也希望中国的产品有朝一日不再是廉价和仿冒的代名词，希望中国的海外卖家能把我们的创新展现给世界人民，希望更多的站点能够崛起和打破阿里的垄断。

最后友情提示，在海外大多数国家，对侵权的打击还是相当严厉的。Paypal是一家美国公司，遵守的是美国司法体系，如果你的站点销售侵权产品，通常Paypal会给你警告，据我所知他们也有专门的巡查部门。但如果一旦你被海外用户取证和诉讼并且事实成立，你的资金就有可能被Paypal冻结。

吴剑 http://www.cnblogs.com/wu-jian

<全文完>

吴剑 http://www.cnblogs.com/wu-jian

![微信打赏][o_weixin.png_r_1]

如果您觉得本文对您有所帮助，可扫描两侧的二维码向作者打赏。您的支持是原创的源动力！  
作者： [吴剑][Link 1]  
出处： [http://www.cnblogs.com/wu-jian/][Link 1]  
本文版权归作者所有，欢迎转载，但必需注明出处，并且在转载页面明显位置给出原文连接，否则保留追究法律责任的权利。

![支付宝打赏][o_zfb.png_r_2]

转载于:https://www.cnblogs.com/wu-jian/p/3614228.html

[http_www.cnblogs.com_wu-jian]: http://www.cnblogs.com/wu-jian
[221208030295478.jpg]: /images/20211211/7338e1b098b6400cad18737f1d7300a8.png
[Paypal]: http://www.cnblogs.com/wu-jian/p/3614228.html
[CyberSource]: http://www.cnblogs.com/wu-jian/p/3664292.html
[171053055416598.jpg]: /images/20211211/fb837fc2b82a4e5caf946c11af323d99.png
[https_developer.paypal.com_docs_classic_api_merchant_SetExpressCheckout_API_Operation_NVP]: https://developer.paypal.com/docs/classic/api/merchant/SetExpressCheckout_API_Operation_NVP/
[https_developer.paypal.com_docs_classic_api_merchant_GetExpressCheckoutDetails_API_Operation_NVP]: https://developer.paypal.com/docs/classic/api/merchant/GetExpressCheckoutDetails_API_Operation_NVP/
[https_developer.paypal.com_webapps_developer_docs_classic_api_merchant_DoExpressCheckoutPayment_API_Operation_NVP]: https://developer.paypal.com/webapps/developer/docs/classic/api/merchant/DoExpressCheckoutPayment_API_Operation_NVP/
[https_developer.paypal.com_webapps_developer_docs_classic_ipn_integration-guide_IPNIntro]: https://developer.paypal.com/webapps/developer/docs/classic/ipn/integration-guide/IPNIntro/
[https_developer.paypal.com_docs_classic_ipn_integration-guide_IPNandPDTVariables]: https://developer.paypal.com/docs/classic/ipn/integration-guide/IPNandPDTVariables/
[250919024204213.jpg]: /images/20211211/32b75569863f4fb9ae45684bc703c84a.png
[250945452958492.jpg]: /images/20211211/a21f41b3b944475c89732129495cc16e.png
[113726-20151126152903890-1794935097.jpg]: /images/20211211/c4d7f3d565f24a10b1e75c80a0ea7095.png
[113726-20151126152915843-1321747795.jpg]: /images/20211211/9bc245030a674d919ca9158dd24664bf.png
[113726-20151126152928906-1566837317.jpg]: /images/20211211/02a19eb5f26e48f38f1d9a281cdb6209.png
[113726-20151126152938562-1544704979.jpg]: /images/20211211/e1c6823603684c8a99d15a01b455b606.png
[o_weixin.png_r_1]: /images/20211211/6920fd4516de42cf96f40a7055eda91f.png
[Link 1]: http://www.cnblogs.com/wu-jian/
[o_zfb.png_r_2]: /images/20211211/3e695f5257df43fe86ed559b6b19d132.png