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

前言

---

 公司一个网站项目有国外的用户给我们发邮件希望能用paypal支付，于是交给了我，我们这个项目两年前是有对接paypal通道的，但是一直没有开放，测试测了并不能完成付款流程。

看paypal官方是最近有出一个新的sdk，老的应该不在支持更新了，于是打算用新的SDK重新对接，新的github地址：https://github.com/paypal/Checkout-PHP-SDK/。

这个项目使用的是thinkphp5框架，但是其他框架使用方法也都差不多。

 

本文只是随笔记录，如果能帮到其他朋友最好，如果有哪里错误或者有疑问的可以在评论区指出，我看到会及时回复的！！！

准备

---

 

 测试账户登录https://developer.paypal.com开发者中心

 

 点开并创建新的App，注意这里分sanbox沙盒环境和live环境，沙盒环境可以创建测试付款和收款账户，live是正式环境的。

 

左侧account可以会有默认的商家账户和普通用户，可以用来沙盒环境测试。

遇到的坑

沙盒环境下用户能扣款，也能收到通知，但是商家账户没有收款记录，发邮件给paypal，说是他们帮我确认下收款邮箱了，然后再试就可以了。

正式环境下国内大陆的paypal账户不能给国内大陆的收款账户付款，但是用visa等信用卡可以选择香港地区进行付款

对接流程

---

 

composer.json添加“paypal/Checkout-PHP-SDK”之后执行 composer update paypal/Checkout-PHP-SDK  记得要带包名，不然所有的包全都更新到最新版了

更新好之后会发现vendor目录多了两个包

 

并且有写好的demo

 

 

 我们目前需要使用的是发起订单，订单扣款，以及订单退款。

 

 发起订单

 

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[1]->href;
                        return $url
                        
                    } catch (HttpException $ex) {
                        throw $ex;
                        //echo $ex->statusCode;
                        //print_r($ex->getMessage());
                    }

                    break;

这里$Config变量是配置参数

这里return的url是需要前端跳转的paypal收银台，用户确认支付后会跳转（这里是同步跳转，异步回调需要ipn或者webhook，后面会提到）

 

 捕获订单

用户支付完成跳转到我们这里并没有完成付款，只是给了授权而已，我们还要根据订单的状态来进行扣款操作。

跳转回来或者异步回调会有“token“参数，可以根据token查询当前的订单状态。

订单状态：

• CREATED. The order was created with the specified context.  创建订单
  
• SAVED. The order was saved and persisted. The order status continues to be in progress until a capture is made with final_capture = true for all purchase units within the order.
• APPROVED. 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.　　已授权
• VOIDED. All purchase units in the order are voided.
• COMPLETED. The payment was authorized or the authorized payment was captured for the order.　　

  public function capture($token){
          //1获取token 2 OrdersGetRequest判断token状态status  3.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;
          }
      }

   

订单退款

        $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);    

 

退款流程应也是根据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才行，因为我们这个项目退款要经过财务，所以就没继续测试下去，有走完流程的朋友可以说一下。

 

付款回调

---

 

 paypal应该是ipn和webhook，但是我看Stack Overflow上有人说ipn方式可能会废弃，所以我们采用了webhook方式

 

webhook需要点开对应的APP下去添加

 

这里可以选全部也可以选需要的事件