盾行云支付用客户端下单好还是服务器下单好呢？

盾行云支付用客户端下单好。

客户端（Client）或称为用户端，是指与服务器相对应，为客户提供本地服务的程序。除了一些只在本地运行的应用程序之外，一般安装在普通的客户机上，需要与服务端互相配合运行。对于这一类应用程序，需要网络中有相应的服务器和服务程序来提供相应的服务，如数据库服务，电子邮件服务等等，这样在客户机和服务器端，需要建立特定的通信连接，来保证应用程序的正常运行。因特网发展以后，较常用的用户端包括了如万维网使用的网页浏览器，收寄电子邮件时的电子邮件客户端，以及即时通讯的客户端软件等。

Server一词，有软硬之分。从硬件的角度而言，Server是物理上存在的服务器；而从软件的角度上说，Server指的是具备服务器端功能的电脑软件，以及正在运行的服务器端软件。整个网络，是由无数的节点和连接通道共同构建而成。而从“硬”的方面说，是由无数的硬件服务器和其他数字化计算设备终端（比如个人电脑、手机等）以及中间连接设备（比如网线、路由器等等）构建而成的。从“软”的方面说，是由无数运行着的服务器端软件和客户端软件（或者说终端软件）以及它们的相互连接交流而构建成的。

因为公司的业务是H5平台的，所以这里只介绍H5方案的接入说明。PayPal提供了丰富的和支付相关的能力，但是我公司的业务仅仅需要普通的一次性消耗付款，所以其它如订阅等功能我也没去了解，就不介绍了。还有注册账号的基本操作这里也不讲了，在PayPal官网按步骤操作即可。我们从创建开发者应用讲起。

点击 https://developer.paypal.com/ 打开PayPal开发者中心，国内环境打开稍微有点满，耐心等待一下。打开后登陆注册好的账号，进入 开发者后台 ，在【My apps &credentials】页面中选择 sandbox 选项卡创建一个沙箱应用，创建好后可以获得clientID和Secret。记录下这两个值，我们后面要用到。

最后可以给这个应用可以设置webhook，即触发某个事件（如完成付款）后，PayPal服务器通过此地址通知你。

因为我是H5平台接入，所有有两种方案可以选择，一种是REST API，一种是Javascript SDK方案。

REST API方案：从服务端向PayPal服务器下单，下单完成后PayPal返回订单ID和支付链接，将支付链接传递给前端用户，用户跳转到PayPal的支付链接付款完成后，会通过跳转回你下单时设置的目的地址，如果你有在PayPal后台设置对应事件的webhook的话，PayPal服务器也会通知你用户已付款。然后你再去PayPal服务器确认订单，确认完成后即完成了整个流程。

Javascript SDK方案：前端页面加载PayPal JS资源，渲染支付按钮，用户点击按钮PayPal SDK自动下单并打开支付页面，用户支付完成后前端返回支付结果，如果你有在PayPal后台设置对应事件的webhook的话，PayPal服务器也会通知你用户已付款。然后你再去PayPal服务器确认订单，确认完成后即完成了整个流程。

这两种方案各有优缺点。REST API方案会跳出你的页面，支付完成再回来只能重新打开你的页面。Javascript SDK方案下单是由前端完成的，服务端都不知道前端什么时候下单的，上来就被我否定了-_-。不过最终找到了一个结合REST API和 Javascript SDK 的第三种方案，既不用跳出页面，也可以由服务端下单。PayPal示例地址: https://developer.paypal.com/demo/checkout/#/pattern/server

下面就说明第三种方案的具体接入要点。

服务端请求 下单接口 。

请求Header中需要设置 Content-Type: application/json 和 Authorization，Authorization可以使用 Bearer Access-Token or Basic client_id:secret 两种方式。使用Bearer Access-Token方式的话需要通过 授权接口 先获得Access-Token。如果使用 Basic client_id:secret 方式的话直接 Basic Base64Encode(client_id:secret) 即可。

请求参数中需要设置币种和金额，如果是单纯的使用REST API方案的话，还需要再application_context中设置一个return_url。CURL示例如下：

下单完成后，会返回PayPal的订单ID，和PayPal的支付链接（approve url）。将PayPal订单ID返回给前端JS SDK，PayPal会自动打开一个页面让用户付款，付款完SDK会通知你用户付款完成。如果再PayPal后台有配置付费事件（Checkout order approved）的webhook的话，PayPal服务器也会通过webhook通知你用户已付款。

此时订单处于APPROVED状态，需要你请求 Capture payment for order 接口去确认订单。CURL示例如下：

如果确认完成，PayPal会响应订单状态为COMPLETED，此状态表示订单已经完成了。

打开开发者后台，进入沙箱账号列表： https://developer.paypal.com/developer/accounts ，点击Create account按钮创建沙箱付款账号，创建完成后点击账号列表后的View/edit account按钮查看账号邮箱和密码。使用此账号即可在沙箱环境中完成付款。

服务端请求 查询订单详情接口 ，按文档接入即可。

在开发者后台，应用列表页面选择Live选项卡，创建正式应用，获得正式clientID和Secret，替换沙箱密钥，并将沙箱接口替换成功正式接口即可。

如果需要服务端接收事件，也需要给正式应用配置对应的webhook。

沙箱接口地址： https://api-m.sandbox.paypal.com

正式接口地址： https://api-m.paypal.com

---