Laravel中集成PayPal

摘要：最近在写一个面向国外买家的一个商城项目，既然面向国外，那就要用到这个支付平台。因为在对接的过程中遇到了一些问题，花费了一些时间，所以把对接的过程记下来，也希望能帮助到用到的朋友。以下皆以代码的形式展现，没有截图，但我尽量用代码讲解明白。

最近在写一个面向国外买家的一个商城项目，既然面向国外，那就要用到PayPal这个支付平台。因为在对接PayPal的过程中遇到了一些问题，花费了一些时间，所以把对接的过程记下来，也希望能帮助到用到PayPal的朋友。

我集成的是paypal/rest-api-sdk-php。PayPal的api有 v1和v2两个版本，我用的这个是v1版本。

以下皆以代码的形式展现，没有截图，但我尽量用代码讲解明白。
假设你已经有了用laravel写的一个项目：

composer require paypal/rest-api-sdk-php

在Config目录新建payment.php配置文件，内容如下

return [
    "paypal" => [
        /** set your paypal credential **/
        "client_id" =>"paypal client_id",
        "secret" => "paypal secret ID",
        /**
         * SDK 配置
         */
        "settings" => array(
            /**
             * 沙盒测试"sandbox" 或者 "live"
             */
               "mode" => "sandbox",
            /**
             * 请求超时时间
             */
            "http.ConnectionTimeOut" => 1000,
            /**
             * 是否开启日志：true开启，false不开启
             */
            "log.LogEnabled" => true,
            /**
             * 日志存储的文件
             */
            "log.FileName" => storage_path() . "/logs/paypal.log",
            /**
             * 日志级别 "DEBUG", "INFO", "WARN" or "ERROR"
                *
             */
            "log.LogLevel" => "INFO"
        ),
    ],
    
    "2checkout" => [
        //
    ]
];

    // 第一步：显示表单，这是一个简单的表单页面，我们把金额输入，然后点击提交
    Route::get("paypal-form", "PaymentPayPalController@payPalShow")->name("paypal-form");

    // 第二步：第一步提交后发送请求，请求该方法，该方法用于创建订单，创建支付流程
    Route::post("paypal-pay", "PaymentPayPalController@pay")->name("payment.paypay.pay");

    // 第三步：异步回调
    Route::post("paypal-notify", "PaymentPayPalController@payPalNotify")->name("payment.paypal.notify");

    // 第三步：前端回调
    Route::get("paypal-return", "PaymentPayPalController@payPalReturn")->name("payment.paypal.return");

    // 第三步：取消
    Route::get("paypal-cancel", "PaymentPayPalController@payPalCancel")->name("payment.paypal.cancel");

_api_context = new ApiContext(new OAuthTokenCredential(
            $payPal_config["client_id"],
            $payPal_config["secret"]
        ));
        $this->_api_context->setConfig($payPal_config["setting"]);
    }

    // 显示表单
    public function payPalShow()
    {
        return view("payment.paypal");
    }
    
    // 第二步，请求这里
    public function pay(Request $request)
    {
        $payer = new Payer();
        $payer->setPaymentMethod("paypal");

        // 产品名称，币种，数量，单个产品金额
        $item1 = new Item();
        $item1->setName("item1")
            ->setCurrency("USD")
            ->setQuantity(1)
            ->setPrice($request->get("amount"));

        // 将所有产品集合到 ItemList中
        $item_list = new ItemList();
        $item_list->setItems([$item1]);

        $amount = new Amount();
        $amount->setCurrency("USD")
            ->setTotal($request->get("amount"));

        // 生成交易
        $transaction = new Transaction();
        $transaction->setAmount($amount)
            ->setItemList($item_list)
            ->setDescription("你的交易")
            ->setNotifyUrl(route("notify_url")) // 注意，这里设置异步回调地址
            ->setInvoiceNumber($order->order_number); // 这里设置订单号

        // 设置前端回调地址和取消支付地址
        $redirect_urls = new RedirectUrls();
        $redirect_urls->setReturnUrl(route("payment.paypal.return"))
        ->setCancelUrl(route("payment.paypal.cancel"));
        
        $payment = new Payment();
        $payment->setIntent("Sale")
            ->setPayer($payer)
            ->setRedirectUrls($redirect_urls)
            ->setTransactions(array($transaction));

        try {
            // 这里生成支付流程
            $payment->create($this->_api_context);
        } catch (PayPalExceptionPayPalConnectionException $ex) {
            if (config("app.debug")) {
                session()->put("error","Connection timeout");
                return redirect()->route("paypal-form");

                /** echo "Exception: " . $ex->getMessage() . PHP_EOL; **/
                /** $err_data = json_decode($ex->getData(), true); **/
                /** exit; **/

            } else {
                session()->put("error","Some error occur, sorry for inconvenient");
                return redirect()->route("paypal-form");
            }
        }

        foreach($payment->getLinks() as $link) {
            if($link->getRel() == "approval_url") {
                $redirect_url = $link->getHref();
                break;
            }
        }

        // $payment->getId()得到的是支付流水号
        session()->put("paypal_payment_id", $payment->getId());

        if(isset($redirect_url)) {
            // 跳转到支付页面
            return redirect()->away($redirect_url);
        }

        session()->put("error","Unknown error occurred");
        return session()->route("paypal-form");
    }
    
    
    public function payPalReturn(Request $request)
    {
        // 支付成功后，在前端页面跳转回来时，url地址中会带有paymentID 和 PayerID
        $payment_id = session()->get("paypal_payment_id");
        session()->forget("paypal_payment_id");

        if (empty(Input::get("PayerID")) || empty(Input::get("token"))) {
            session()->put("error","Payment failed");

            return redirect()->route("paypal-form");
        }
        $payment = Payment::get($payment_id, $this->_api_context);
        $execution = new PaymentExecution();
        $execution->setPayerId(Input::get("PayerID"));
        $result = $payment->execute($execution, $this->_api_context);


        // 当拿到的状态时approved表示支付成功
        if ($result->getState() == "approved") {

            session()->put("success","Payment success");
            return redirect()->route("paypal-form");
        }
        session()->put("error","Payment failed");

        return redirect()->route("paypal-form");
    }
    
    public function payPalNotify()
    {
        Log::info(12312, Input::get());
        // 这里写我们的业务逻辑，订单状态更新，物流信息等等.
    }
}

    {{ csrf_field() }}
    
    

        Amount
    
        

            
    
            @if ($errors->has("amount"))
                
                    {{ $errors->first("amount") }}
                
            @endif
        
    
    
    

        

            
                Paywith Paypal
            
        
    

以上既是我做商城项目时PayPal的对接流程，因为英语不好的问题，开发起来会出现很多问题，
如果英文好，想知道更多的用法，可以看PayPal的开发者文档，还有demo演示。