php对接“paypal/Checkout-PHP-SDK“支付流程

云上君阙 發表於 2020-9-3 14:51:00

php对接“paypal/Checkout-PHP-SDK“支付流程

<h2 data-id="heading-1">前言</h2>
<hr>
 公司一个网站项目有国外的用户给我们发邮件希望能用paypal支付，于是交给了我，我们这个项目两年前是有对接paypal通道的，但是一直没有开放，测试测了并不能完成付款流程。
看paypal官方是最近有出一个新的sdk，老的应该不在支持更新了，于是打算用新的SDK重新对接，新的github地址：https://github.com/paypal/Checkout-PHP-SDK/。
这个项目使用的是thinkphp5框架，但是其他框架使用方法也都差不多。
 
本文只是随笔记录，如果能帮到其他朋友最好，如果有哪里错误或者有疑问的可以在评论区指出，我看到会及时回复的！！！
<h2 data-id="heading-1">准备</h2>
<hr>
 
 测试账户登录https://developer.paypal.com开发者中心
<img src="https://img2020.cnblogs.com/blog/1851735/202009/1851735-20200903143132237-1660597356.png" alt="" loading="lazy">
 
 点开并创建新的App，注意这里分sanbox沙盒环境和live环境，沙盒环境可以创建测试付款和收款账户，live是正式环境的。
<img src="https://img2020.cnblogs.com/blog/1851735/202009/1851735-20200903143232435-811630520.png" width="900" loading="lazy">
 
左侧account可以会有默认的商家账户和普通用户，可以用来沙盒环境测试。
遇到的坑
沙盒环境下用户能扣款，也能收到通知，但是商家账户没有收款记录，发邮件给paypal，说是他们帮我确认下收款邮箱了，然后再试就可以了。
正式环境下国内大陆的paypal账户不能给国内大陆的收款账户付款，但是用visa等信用卡可以选择香港地区进行付款
<h2 data-id="heading-1">对接流程</h2>
<hr>
 
composer.json添加“paypal/Checkout-PHP-SDK”之后执行 <code>composer update paypal/Checkout-PHP-SDK  记得要带包名，不然所有的包全都更新到最新版了</code>
更新好之后会发现vendor目录多了两个包
<img src="https://img2020.cnblogs.com/blog/1851735/202009/1851735-20200903135318283-816422447.png" alt="" loading="lazy">
 
并且有写好的demo
<img src="https://img2020.cnblogs.com/blog/1851735/202009/1851735-20200903135359508-339657956.png" alt="" loading="lazy">
 
 
 我们目前需要使用的是发起订单，订单扣款，以及订单退款。
 
 发起订单
 
<div class="cnblogs_code">
<pre>case 'paypal':
 if(!isset($Config['app_id']) || !isset($Config['app_secret'])){
 throw new \think\Exception('paypal配置错误');
 }

 $request = new OrdersCreateRequest();
 $request->prefer('return=representation');

 $returnUrl = isset($Config['return_url']) ? $Config['return_url'] : 'https://xxx.com/pay/callback/paypal?act=success';　　　　//成功跳转地址
 $cancelUrl = isset($Config['cancel_url']) ? $Config['cancel_url'] : 'https://xxx.com/pay/callback/paypal?act=cancel';　　　　//取消跳转地址

 $request->body = array(
 'intent' => 'CAPTURE',
 'application_context' =>
 array(
 'return_url' => $returnUrl,
 'cancel_url' => $cancelUrl
 ),
 'purchase_units' =>
 array(
 0 =>
 array(
 'amount' =>
 array(
 'currency_code' => 'USD',　　　　//币种-paypal文档有
 'value' => '0.01'　　//金额
 )
 )
 )
 );
 // 是否是沙盒模式
 $envSet = $Config['use_sandbox'] ? 'PayPalCheckoutSdk\Core\SandboxEnvironment' : 'PayPalCheckoutSdk\Core\ProductionEnvironment';

 try {
 $environment = new $envSet($Config['app_id'], $Config['app_secret']);
 $client = new PayPalHttpClient($environment);
 $response = $client->execute($request);
 $url = $response->result->links->href;
 return $url

 } catch (HttpException $ex) {
 throw $ex;
 //echo $ex->statusCode;
 //print_r($ex->getMessage());
 }

 break;</pre>
</div>
这里$Config变量是配置参数
这里return的url是需要前端跳转的paypal收银台，用户确认支付后会跳转（这里是同步跳转，异步回调需要ipn或者webhook，后面会提到）
 
 捕获订单
用户支付完成跳转到我们这里并没有完成付款，只是给了授权而已，我们还要根据订单的状态来进行扣款操作。
跳转回来或者异步回调会有“token“参数，可以根据token查询当前的订单状态。
订单状态：
<ul>
<li><code class="dax-def-enum-item">CREATED</code>. The order was created with the specified context.  创建订单 </li>
<li><code class="dax-def-enum-item">SAVED</code>. The order was saved and persisted. The order status continues to be in progress until a capture is made with <code>final_capture = true</code> for all purchase units within the order.</li>
<li><code class="dax-def-enum-item">APPROVED</code>. The customer approved the payment through the PayPal wallet or another form of guest or unbranded payment. For example, a card, bank account, or so on.　　已授权</li>
<li><code class="dax-def-enum-item">VOIDED</code>. All purchase units in the order are voided.</li>
<li><code class="dax-def-enum-item">COMPLETED</code>. The payment was authorized or the authorized payment was captured for the order.　　
<div class="cnblogs_code">
<pre>public function capture($token){
 //1获取token 2 OrdersGetRequest判断token状态status3.COMPLETED 则已完成 APPROVED 则已经批准进入 captureOrder 判断返回结果COMPLETED 则已完成其他则打印log
 try {
 //client
 $Config = \think\Config::get('paypal');
 $envSet = $Config['use_sandbox'] ? 'PayPalCheckoutSdk\Core\SandboxEnvironment' : 'PayPalCheckoutSdk\Core\ProductionEnvironment';
 $environment = new $envSet($Config['app_id'], $Config['app_secret']);
 $client = new PayPalHttpClient($environment);

 //先判断订单当前状态-防止订单已经是已完成状态，再次扣款
 $request = new OrdersGetRequest($token);
 $response = $client->execute($request);
 if(!isset($response->result->status))
 throw new HttpException(__CLASS__ .'参数未获取到，token:'.$token);
 $status = $response->result->status;
 switch ($status){
 case 'COMPLETED': //订单已经完成
 //
 break;
 case 'APPROVED': //获取支付金额
 $captureRequest = new OrdersCaptureRequest($token);
 $captureRequest->prefer('return=minimal'); //简洁参数-获取更多参数用return=representation
 $captureResponse = $client->execute($captureRequest);
 //返回状态不是已完成
 if($captureResponse->result->status != 'COMPLETED')
 throw new HttpException(__CLASS__ .'captureOrder 失败，token:'.$token.' status:'.$captureResponse->result->status);
 break;
 default: //其他
 throw new HttpException(__CLASS__ .'参数未知，token:'.$token.' status:'.$status);
 break;
 }
 //订单支付完成
 return true;
 }catch (HttpException $ex) {
 Log::write($ex->getMessage());
 return false;
 }
}</pre>
</div>
 
</li>
</ul>
订单退款
<div class="cnblogs_code">
<pre> $request = new CapturesRefundRequest($token);
 $Config = \think\Config::get('paypal');
 $envSet = $Config['use_sandbox'] ? 'PayPalCheckoutSdk\Core\SandboxEnvironment' : 'PayPalCheckoutSdk\Core\ProductionEnvironment';
 $environment = new $envSet($Config['app_id'], $Config['app_secret']);
 $client = new PayPalHttpClient($environment);

 $response = $client->execute($request); </pre>
</div>
 
退款流程应也是根据token来操作，但是我这边提示我“description":"You do not have permission to access or perform operations on this resource.” 
https://stackoverflow.com/questions/54907374/paypal-refund-rest-api-v2-authorization-failed-due-to-insufficient-permissions   这里说是需要新建一个app_id才行，因为我们这个项目退款要经过财务，所以就没继续测试下去，有走完流程的朋友可以说一下。
 
付款回调
<hr>
 
 paypal应该是ipn和webhook，但是我看Stack Overflow上有人说ipn方式可能会废弃，所以我们采用了webhook方式
 
webhook需要点开对应的APP下去添加
<img src="https://img2020.cnblogs.com/blog/1851735/202009/1851735-20200903144709333-87889483.png" alt="" loading="lazy">
 
这里可以选全部也可以选需要的事件
  
来源：https://www.cnblogs.com/xiaolele1/p/13607517.html

頁: [1]

琼殿技术论坛's Archiver

php对接“paypal/Checkout-PHP-SDK“支付流程