最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

Paypal實現(xiàn)循環(huán)扣款(訂閱)功能

 更新時間:2017年03月23日 14:51:16   作者:楓葉落一地  
本文主要介紹了Paypal實現(xiàn)循環(huán)扣款(訂閱)的思路與方法;并對如何使用Paypal的支付接口下總結(jié),具有很好的參考價值,下面跟著小編一起來看下吧

起因

業(yè)務(wù)需求要集成Paypal,實現(xiàn)循環(huán)扣款功能,然而百度和GOOGLE了一圈,除官網(wǎng)外,沒找到相關(guān)開發(fā)教程,只好在Paypal上看,花了兩天后集成成功,這里對如何使用Paypal的支付接口下總結(jié)。

Paypal現(xiàn)在有多套接口:

  • 通過Braintree(后面會談Braintree)實現(xiàn)Express Checkout;
  • 創(chuàng)建App,通過REST Api的接口方式(現(xiàn)在的主流接口方式);
  • NVP/SOAP API apps的接口(舊接口);

REST API

這是順應(yīng)時代發(fā)展的產(chǎn)物,如果你之前用過OAuth 2.0與REST API,那看這些接口應(yīng)該不會有什么困惑。

舊接口

除非REST API接口有不能滿足的,比如政策限制,否則不推薦使用。全世界都在往OAuth 2.0的認(rèn)證方式和REST API的API使用方式遷移,干嘛逆勢而行呢。因此在REST API能解決問題情況下,我也沒對這套接口深入比較。

REST API的介紹

官方的API參考文檔https://developer.paypal.com/webapps/developer/docs/api/對于其API和使用方式有較詳細(xì)的介紹,但是如果自己直接調(diào)這些API還是很繁瑣的,同時我們只想盡快完成業(yè)務(wù)要求而不是陷入對API的深入了解。

那么如何開始呢,建議直接安裝官方提供的PayPal-PHP-SDK,通過其Wiki作為起點。

在完成首個例子之前,請確保你有Sandbox帳號,并正確配置了:

  • Client ID
  • Client Secret
  • Webhook API(必須是https開頭且是443端口,本地調(diào)試建議結(jié)合ngrok反向生成地址)
  • Returnurl(注意項同上)

在完成Wiki的首個例子后,理解下接口的分類有助于完成你的業(yè)務(wù)需求,下面我對接口分類做個介紹,請結(jié)合例子理解http://paypal.github.io/PayPal-PHP-SDK/sample/#payments。

  • Payments 一次性支付接口,不支持循環(huán)捐款。主要支付內(nèi)容有支持Paypal支付,信用卡支付,通過已保存的信用卡支持(需要使用Vault接口,會有這樣的接口主要是PCI的要求,不允許一般的網(wǎng)站采集信用卡的敏感信息),支持付給第三方收款人。
  • Payouts 沒用到,忽略;
  • Authorization and Capture 支持直接通過Paypal的帳號登陸你的網(wǎng)站,并獲取相關(guān)信息;
  • Sale 跟商城有關(guān),沒用到,忽略;
  • Order 跟商城有關(guān),沒用到,忽略;
  • Billing Plan & Agreements 升級計劃和簽約,也就是訂閱功能,實現(xiàn)循環(huán)扣款必須使用這里的功能,這是本文的重點;
  • Vault 存儲信用卡信息
  • Payment Experience 沒用到,忽略;
  • Notifications 處理Webhook的信息,重要,但不是本文關(guān)注內(nèi)容;
  • Invoice 票據(jù)處理;
  • Identity 認(rèn)證處理,實現(xiàn)OAuth 2.0的登陸,獲取對應(yīng)token以便請求其他API,這塊Paypal-PHP-SDK已經(jīng)做進去,本文也不談。

如何實現(xiàn)循環(huán)扣款

分四個步驟:

  1. 創(chuàng)建升級計劃,并激活;
  2. 創(chuàng)建訂閱(創(chuàng)建Agreement),然后將跳轉(zhuǎn)到Paypal的網(wǎng)站等待用戶同意;
  3. 用戶同意后,執(zhí)行訂閱
  4. 獲取扣款帳單

1.創(chuàng)建升級計劃

升級計劃對應(yīng)Plan這個類。這一步有幾個注意點:

  • 升級計劃創(chuàng)建后,處于CREATED狀態(tài),必須將狀態(tài)修改為ACTIVE才能正常使用。
  • Plan有PaymentDefinition和MerchantPreferences兩個對象,這兩個對象都不能為空;
  • 如果想創(chuàng)建TRIAL類型的計劃,該計劃還必須有配套的REGULAR的支付定義,否則會報錯;
  • 看代碼有調(diào)用一個setSetupFee(非常,非常,非常重要)方法,該方法設(shè)置了完成訂閱后首次扣款的費用,而Agreement對象的循環(huán)扣款方法設(shè)置的是第2次開始時的費用。

以創(chuàng)建一個Standard的計劃為例,其參數(shù)如下:

$param = [
 "name" => "standard_monthly",
 "display_name" => "Standard Plan",
 "desc" => "standard Plan for one month",
 "type" => "REGULAR",
 "frequency" => "MONTH",
 "frequency_interval" => 1,
 "cycles" => 0,
 "amount" => 20,
 "currency" => "USD"
 ];

創(chuàng)建并激活計劃代碼如下:

 //上面的$param例子是個數(shù)組,我的實際應(yīng)用傳入的實際是個對象,用戶理解下就好。
 public function createPlan($param)
 {
 $apiContext = $this->getApiContext();
 $plan = new Plan();
 // # Basic Information
 // Fill up the basic information that is required for the plan
 $plan->setName($param->name)
 ->setDescription($param->desc)
 ->setType('INFINITE');//例子總是設(shè)置為無限循環(huán)
 // # Payment definitions for this billing plan.
 $paymentDefinition = new PaymentDefinition();
 // The possible values for such setters are mentioned in the setter method documentation.
 // Just open the class file. e.g. lib/PayPal/Api/PaymentDefinition.php and look for setFrequency method.
 // You should be able to see the acceptable values in the comments.
 $paymentDefinition->setName($param->name)
 ->setType($param->type)
 ->setFrequency($param->frequency)
 ->setFrequencyInterval((string)$param->frequency_interval)
 ->setCycles((string)$param->cycles)
 ->setAmount(new Currency(array('value' => $param->amount, 'currency' => $param->currency)));
 // Charge Models
 $chargeModel = new ChargeModel();
 $chargeModel->setType('TAX')
 ->setAmount(new Currency(array('value' => 0, 'currency' => $param->currency)));
 $returnUrl = config('payment.returnurl');
 $merchantPreferences = new MerchantPreferences();
 $merchantPreferences->setReturnUrl("$returnUrl?success=true")
 ->setCancelUrl("$returnUrl?success=false")
 ->setAutoBillAmount("yes")
 ->setInitialFailAmountAction("CONTINUE")
 ->setMaxFailAttempts("0")
 ->setSetupFee(new Currency(array('value' => $param->amount, 'currency' => 'USD')));
 $plan->setPaymentDefinitions(array($paymentDefinition));
 $plan->setMerchantPreferences($merchantPreferences);
 // For Sample Purposes Only.
 $request = clone $plan;
 // ### Create Plan
 try {
 $output = $plan->create($apiContext);
 } catch (Exception $ex) {
 return false;
 }
 $patch = new Patch();
 $value = new PayPalModel('{"state":"ACTIVE"}');
 $patch->setOp('replace')
 ->setPath('/')
 ->setValue($value);
 $patchRequest = new PatchRequest();
 $patchRequest->addPatch($patch);
 $output->update($patchRequest, $apiContext);
 return $output;
 }

2.創(chuàng)建訂閱(創(chuàng)建Agreement),然后將跳轉(zhuǎn)到Paypal的網(wǎng)站等待用戶同意

Plan創(chuàng)建后,要怎么讓用戶訂閱呢,其實就是創(chuàng)建Agreement,關(guān)于Agreement,注意點:

  • 正如前面所述,Plan對象的setSetupFee方法,設(shè)置了完成訂閱后首次扣款的費用,而Agreement對象的循環(huán)扣款方法設(shè)置的是第2次開始時的費用。
  • setStartDate方法設(shè)置的是第2次扣款時的時間,因此如果你按月循環(huán),應(yīng)該是當(dāng)前時間加一個月,同時該方法要求時間格式是ISO8601格式,使用Carbon庫可輕松解決;
  • 在創(chuàng)建Agreement的時候,此時還沒有生成唯一ID,于是我碰到了一點小困難:那就是當(dāng)用戶完成訂閱的時候,我怎么知道這個訂閱是哪個用戶的?通過Agreement的getApprovalLink方法得到的URL,里面的token是唯一的,我通過提取該token作為識別方式,在用戶完成訂閱后替換成真正的ID。

例子參數(shù)如下:

$param = [
 'id' => 'P-26T36113JT475352643KGIHY',//上一步創(chuàng)建Plan時生成的ID
 'name' => 'Standard', 
 'desc' => 'Standard Plan for one month'
];

代碼如下:

 public function createPayment($param)
 {
 $apiContext = $this->getApiContext();
 $agreement = new Agreement();
 $agreement->setName($param['name'])
 ->setDescription($param['desc'])
 ->setStartDate(Carbon::now()->addMonths(1)->toIso8601String());
 // Add Plan ID
 // Please note that the plan Id should be only set in this case.
 $plan = new Plan();
 $plan->setId($param['id']);
 $agreement->setPlan($plan);
 // Add Payer
 $payer = new Payer();
 $payer->setPaymentMethod('paypal');
 $agreement->setPayer($payer);
 // For Sample Purposes Only.
 $request = clone $agreement;
 // ### Create Agreement
 try {
 // Please note that as the agreement has not yet activated, we wont be receiving the ID just yet.
 $agreement = $agreement->create($apiContext);
 // ### Get redirect url
 // The API response provides the url that you must redirect
 // the buyer to. Retrieve the url from the $agreement->getApprovalLink()
 // method
 $approvalUrl = $agreement->getApprovalLink();
 } catch (Exception $ex) {
 return "create payment failed, please retry or contact the merchant.";
 }
 return $approvalUrl;//跳轉(zhuǎn)到$approvalUrl,等待用戶同意
 }

函數(shù)執(zhí)行后返回$approvalUrl,記得通過redirect($approvalUrl)跳轉(zhuǎn)到Paypal的網(wǎng)站等待用戶支付。

用戶同意后,執(zhí)行訂閱

用戶同意后,訂閱還未完成,必須執(zhí)行Agreement的execute方法才算完成真正的訂閱。這一步的注意點在于

  • 完成訂閱后,并不等于扣款,可能會延遲幾分鐘;
  • 如果第一步的setSetupFee費用設(shè)置為0,則必須等到循環(huán)扣款的時間到了才會產(chǎn)生訂單;

代碼片段如下:

 public function onPay($request)
 {
 $apiContext = $this->getApiContext();
 if ($request->has('success') && $request->success == 'true') {
 $token = $request->token;
 $agreement = new \PayPal\Api\Agreement();
 try {
 $agreement->execute($token, $apiContext);
 } catch(\Exception $e) {
 return ull;
 return $agreement;
 }
 return null;
 }

獲取交易記錄

訂閱后,可能不會立刻產(chǎn)生交易扣費的交易記錄,如果為空則過幾分鐘再次嘗試。本步驟注意點:

  • start_date與end_date不能為空
  • 實際測試時,該函數(shù)返回的對象不能總是返回空的JSON對象,因此如果有需要輸出JSON,請根據(jù)AgreementTransactions的API說明,手動取出對應(yīng)參數(shù)。
 /** 獲取交易記錄
 * @param $id subscription payment_id
 * @warning 總是獲取該subscription的所有記錄
 */
 public function transactions($id)
 {
 $apiContext = $this->getApiContext();
 $params = ['start_date' => date('Y-m-d', strtotime('-15 years')), 'end_date' => date('Y-m-d', strtotime('+5 days'))];
 try {
 $result = Agreement::searchTransactions($id, $params, $apiContext);
 } catch(\Exception $e) {
 Log::error("get transactions failed" . $e->getMessage());
 return null;
 }
 return $result->getAgreementTransactionList() ;
 }

最后,Paypal官方當(dāng)然也有對應(yīng)的教程,不過是調(diào)用原生接口的,跟我上面流程不一樣點在于只說了前3步,供有興趣的參考:https://developer.paypal.com/docs/integration/direct/billing-plans-and-agreements/

需要考慮的問題

功能是實現(xiàn)了,但是也發(fā)現(xiàn)不少注意點:

  • 國內(nèi)使用Sandbox測試時連接特別慢,經(jīng)常提示超時或出錯,因此需要特別考慮執(zhí)行中途用戶關(guān)閉頁面的情況;
  • 一定要實現(xiàn)webhook,否則當(dāng)用戶進Paypal取消訂閱時,你的網(wǎng)站將得不到通知;
  • 訂閱(Agreement)一旦產(chǎn)生,除非主動取消,否則將一直生效。因此如果你的網(wǎng)站設(shè)計了多個升級計劃(比如Basic,Standard,Advanced),當(dāng)用戶已經(jīng)訂閱某個計劃后,去切換升級計劃時,開發(fā)上必須取消前一個升級計劃;
  • 用戶同意訂閱-(取消舊訂閱-完成新訂閱的簽約-修改用戶信息為新的訂閱),括號整個過程 應(yīng)該是原子操作,同時耗時又長,因此應(yīng)該將其放到隊列中執(zhí)行直到成功體驗會更好。

以上就是本文的全部內(nèi)容,希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作能帶來一定的幫助,同時也希望多多支持腳本之家!

相關(guān)文章

  • php數(shù)組的概述及分類與聲明代碼演示

    php數(shù)組的概述及分類與聲明代碼演示

    本文將詳細(xì)介紹下php數(shù)組的概述/數(shù)組的分類及數(shù)組多種聲明方式,代碼很規(guī)范,適合初學(xué)者學(xué)習(xí),感興趣的你可不要錯過了哈,希望本例知識點可以幫助到你
    2013-02-02
  • 詳解PHP使用非對稱加密算法RSA

    詳解PHP使用非對稱加密算法RSA

    這篇文章主要介紹了PHP使用非對稱加密算法RSA,對算法感興趣的同學(xué),一定要看一下
    2021-04-04
  • php事務(wù)回滾簡單實現(xiàn)方法示例

    php事務(wù)回滾簡單實現(xiàn)方法示例

    這篇文章主要介紹了php事務(wù)回滾簡單實現(xiàn)方法,結(jié)合實例形式分析了php事務(wù)的定義、提交及回滾事務(wù)的具體操作技巧,需要的朋友可以參考下
    2017-03-03
  • php daddslashes()和 saddslashes()有哪些區(qū)別分析

    php daddslashes()和 saddslashes()有哪些區(qū)別分析

    在Discuze 開源項目中會經(jīng)常用到 saddslashes 函數(shù),這里簡單介紹下,方便需要的朋友
    2012-10-10
  • php獲取圖片信息的方法詳解

    php獲取圖片信息的方法詳解

    這篇文章主要介紹了php獲取圖片信息的方法,結(jié)合實例形式較為詳細(xì)的分析了php獲取圖片信息的相關(guān)函數(shù)及用法,并給出了通過自定義函數(shù)實現(xiàn)獲取圖片信息的方法演示,需要的朋友可以參考下
    2015-12-12
  • 解析php中獲取url與物理路徑的總結(jié)

    解析php中獲取url與物理路徑的總結(jié)

    本篇文章是對php中獲取url與物理路徑進行了詳細(xì)的總結(jié)介紹,需要的朋友參考下
    2013-06-06
  • php?ZipArchive解壓縮實現(xiàn)后臺管理升級問題詳解

    php?ZipArchive解壓縮實現(xiàn)后臺管理升級問題詳解

    php?ZipArchive可以說是php自帶的一個函數(shù)了,他可對對文件進行壓縮與解壓縮處理,但是使用此類之前我們必須在php.ini中把extension=php_zip.dll前面的分號有沒有去掉,然后再重啟Apache這樣才能使用這個類庫
    2022-12-12
  • 利用ThinkPHP內(nèi)置的ThinkAjax實現(xiàn)異步傳輸技術(shù)的實現(xiàn)方法

    利用ThinkPHP內(nèi)置的ThinkAjax實現(xiàn)異步傳輸技術(shù)的實現(xiàn)方法

    ThinkPHP的官方文檔沒有給出ThinkAjax的使用方法,令很多初學(xué)者使用起來有些不便,今天學(xué)到這里,也碰到了很多問題,花時間深究下,做個學(xué)習(xí)筆記,希望能對初學(xué)者有幫助
    2011-12-12
  • php DES加密算法實例分析

    php DES加密算法實例分析

    這篇文章主要介紹了php DES加密算法,結(jié)合實例形式分析了yii框架的DES加密算法類定義,以及兼容C#和java的3DES加密算法實現(xiàn)技巧,需要的朋友可以參考下
    2019-09-09
  • php簡單靜態(tài)頁生成過程

    php簡單靜態(tài)頁生成過程

    一直用smarty的cache,但感覺還是要自己做一個,才有感覺。網(wǎng)上有很多牛人的功能比較完備,打算先自己搞簡單的再慢慢豐滿。這兩天做了一個比較簡單的,在hi.baidu.net/alex_wang58記錄一下。
    2008-03-03

最新評論

奈曼旗| 北川| 衡东县| 象州县| 韶关市| 阜南县| 连州市| 罗甸县| 高平市| 沂源县| 田阳县| 新晃| 东海县| 丽江市| 高碑店市| 剑川县| 鲁甸县| 唐河县| 莱州市| 峨眉山市| 永嘉县| 诸城市| 雷波县| 嵊泗县| 娱乐| 安徽省| 天津市| 新民市| 涟源市| 宁明县| 米易县| 玉树县| 方山县| 军事| 巢湖市| 甘孜| 东辽县| 盐边县| 滦南县| 新疆| 磴口县|