Paypal实现循环扣款(订阅)功能

 更新时间:2017年03月23日 14:51:16   作者:枫叶落一地  
本文主要介绍了Paypal实现循环扣款(订阅)的思路与方法;并对如何使用Paypal的支付接口下总结,具有很好的参考价值,下面跟着小编一起来看下吧

起因

业务需求要集成Paypal,实现循环扣款功能,然而百度和GOOGLE了一圈,除官网外,没找到相关开发教程,只好在Paypal上看,花了两天后集成成功,这里对如何使用Paypal的支付接口下总结。

Paypal现在有多套接口:

  • 通过Braintree(后面会谈Braintree)实现Express Checkout;
  • 创建App,通过REST Api的接口方式(现在的主流接口方式);
  • NVP/SOAP API apps的接口(旧接口);

REST API

这是顺应时代发展的产物,如果你之前用过OAuth 2.0与REST API,那看这些接口应该不会有什么困惑。

旧接口

除非REST API接口有不能满足的,比如政策限制,否则不推荐使用。全世界都在往OAuth 2.0的认证方式和REST API的API使用方式迁移,干嘛逆势而行呢。因此在REST API能解决问题情况下,我也没对这套接口深入比较。

REST API的介绍

官方的API参考文档https://developer.paypal.com/webapps/developer/docs/api/对于其API和使用方式有较详细的介绍,但是如果自己直接调这些API还是很繁琐的,同时我们只想尽快完成业务要求而不是陷入对API的深入了解。

那么如何开始呢,建议直接安装官方提供的PayPal-PHP-SDK,通过其Wiki作为起点。

在完成首个例子之前,请确保你有Sandbox帐号,并正确配置了:

  • Client ID
  • Client Secret
  • Webhook API(必须是https开头且是443端口,本地调试建议结合ngrok反向生成地址)
  • Returnurl(注意项同上)

在完成Wiki的首个例子后,理解下接口的分类有助于完成你的业务需求,下面我对接口分类做个介绍,请结合例子理解http://paypal.github.io/PayPal-PHP-SDK/sample/#payments

  • Payments 一次性支付接口,不支持循环捐款。主要支付内容有支持Paypal支付,信用卡支付,通过已保存的信用卡支持(需要使用Vault接口,会有这样的接口主要是PCI的要求,不允许一般的网站采集信用卡的敏感信息),支持付给第三方收款人。
  • Payouts 没用到,忽略;
  • Authorization and Capture 支持直接通过Paypal的帐号登陆你的网站,并获取相关信息;
  • Sale 跟商城有关,没用到,忽略;
  • Order 跟商城有关,没用到,忽略;
  • Billing Plan & Agreements 升级计划和签约,也就是订阅功能,实现循环扣款必须使用这里的功能,这是本文的重点;
  • Vault 存储信用卡信息
  • Payment Experience 没用到,忽略;
  • Notifications 处理Webhook的信息,重要,但不是本文关注内容;
  • Invoice 票据处理;
  • Identity 认证处理,实现OAuth 2.0的登陆,获取对应token以便请求其他API,这块Paypal-PHP-SDK已经做进去,本文也不谈。

如何实现循环扣款

分四个步骤:

  1. 创建升级计划,并激活;
  2. 创建订阅(创建Agreement),然后将跳转到Paypal的网站等待用户同意;
  3. 用户同意后,执行订阅
  4. 获取扣款帐单

1.创建升级计划

升级计划对应Plan这个类。这一步有几个注意点:

  • 升级计划创建后,处于CREATED状态,必须将状态修改为ACTIVE才能正常使用。
  • Plan有PaymentDefinition和MerchantPreferences两个对象,这两个对象都不能为空;
  • 如果想创建TRIAL类型的计划,该计划还必须有配套的REGULAR的支付定义,否则会报错;
  • 看代码有调用一个setSetupFee(非常,非常,非常重要)方法,该方法设置了完成订阅后首次扣款的费用,而Agreement对象的循环扣款方法设置的是第2次开始时的费用。

以创建一个Standard的计划为例,其参数如下:

$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"
 ];

创建并激活计划代码如下:

 //上面的$param例子是个数组,我的实际应用传入的实际是个对象,用户理解下就好。
 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');//例子总是设置为无限循环
 // # 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.创建订阅(创建Agreement),然后将跳转到Paypal的网站等待用户同意

Plan创建后,要怎么让用户订阅呢,其实就是创建Agreement,关于Agreement,注意点:

  • 正如前面所述,Plan对象的setSetupFee方法,设置了完成订阅后首次扣款的费用,而Agreement对象的循环扣款方法设置的是第2次开始时的费用。
  • setStartDate方法设置的是第2次扣款时的时间,因此如果你按月循环,应该是当前时间加一个月,同时该方法要求时间格式是ISO8601格式,使用Carbon库可轻松解决;
  • 在创建Agreement的时候,此时还没有生成唯一ID,于是我碰到了一点小困难:那就是当用户完成订阅的时候,我怎么知道这个订阅是哪个用户的?通过Agreement的getApprovalLink方法得到的URL,里面的token是唯一的,我通过提取该token作为识别方式,在用户完成订阅后替换成真正的ID。

例子参数如下:

$param = [
 'id' => 'P-26T36113JT475352643KGIHY',//上一步创建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;//跳转到$approvalUrl,等待用户同意
 }

函数执行后返回$approvalUrl,记得通过redirect($approvalUrl)跳转到Paypal的网站等待用户支付。

用户同意后,执行订阅

用户同意后,订阅还未完成,必须执行Agreement的execute方法才算完成真正的订阅。这一步的注意点在于

  • 完成订阅后,并不等于扣款,可能会延迟几分钟;
  • 如果第一步的setSetupFee费用设置为0,则必须等到循环扣款的时间到了才会产生订单;

代码片段如下:

 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;
 }

获取交易记录

订阅后,可能不会立刻产生交易扣费的交易记录,如果为空则过几分钟再次尝试。本步骤注意点:

  • start_date与end_date不能为空
  • 实际测试时,该函数返回的对象不能总是返回空的JSON对象,因此如果有需要输出JSON,请根据AgreementTransactions的API说明,手动取出对应参数。
 /** 获取交易记录
 * @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官方当然也有对应的教程,不过是调用原生接口的,跟我上面流程不一样点在于只说了前3步,供有兴趣的参考:https://developer.paypal.com/docs/integration/direct/billing-plans-and-agreements/

需要考虑的问题

功能是实现了,但是也发现不少注意点:

  • 国内使用Sandbox测试时连接特别慢,经常提示超时或出错,因此需要特别考虑执行中途用户关闭页面的情况;
  • 一定要实现webhook,否则当用户进Paypal取消订阅时,你的网站将得不到通知;
  • 订阅(Agreement)一旦产生,除非主动取消,否则将一直生效。因此如果你的网站设计了多个升级计划(比如Basic,Standard,Advanced),当用户已经订阅某个计划后,去切换升级计划时,开发上必须取消前一个升级计划;
  • 用户同意订阅-(取消旧订阅-完成新订阅的签约-修改用户信息为新的订阅),括号整个过程 应该是原子操作,同时耗时又长,因此应该将其放到队列中执行直到成功体验会更好。

以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,同时也希望多多支持脚本之家!

相关文章

  • php数组的概述及分类与声明代码演示

    php数组的概述及分类与声明代码演示

    本文将详细介绍下php数组的概述/数组的分类及数组多种声明方式,代码很规范,适合初学者学习,感兴趣的你可不要错过了哈,希望本例知识点可以帮助到你
    2013-02-02
  • 详解PHP使用非对称加密算法RSA

    详解PHP使用非对称加密算法RSA

    这篇文章主要介绍了PHP使用非对称加密算法RSA,对算法感兴趣的同学,一定要看一下
    2021-04-04
  • php事务回滚简单实现方法示例

    php事务回滚简单实现方法示例

    这篇文章主要介绍了php事务回滚简单实现方法,结合实例形式分析了php事务的定义、提交及回滚事务的具体操作技巧,需要的朋友可以参考下
    2017-03-03
  • php daddslashes()和 saddslashes()有哪些区别分析

    php daddslashes()和 saddslashes()有哪些区别分析

    在Discuze 开源项目中会经常用到 saddslashes 函数,这里简单介绍下,方便需要的朋友
    2012-10-10
  • php获取图片信息的方法详解

    php获取图片信息的方法详解

    这篇文章主要介绍了php获取图片信息的方法,结合实例形式较为详细的分析了php获取图片信息的相关函数及用法,并给出了通过自定义函数实现获取图片信息的方法演示,需要的朋友可以参考下
    2015-12-12
  • 解析php中获取url与物理路径的总结

    解析php中获取url与物理路径的总结

    本篇文章是对php中获取url与物理路径进行了详细的总结介绍,需要的朋友参考下
    2013-06-06
  • php ZipArchive解压缩实现后台管理升级问题详解

    php ZipArchive解压缩实现后台管理升级问题详解

    php ZipArchive可以说是php自带的一个函数了,他可对对文件进行压缩与解压缩处理,但是使用此类之前我们必须在php.ini中把extension=php_zip.dll前面的分号有没有去掉,然后再重启Apache这样才能使用这个类库
    2022-12-12
  • 利用ThinkPHP内置的ThinkAjax实现异步传输技术的实现方法

    利用ThinkPHP内置的ThinkAjax实现异步传输技术的实现方法

    ThinkPHP的官方文档没有给出ThinkAjax的使用方法,令很多初学者使用起来有些不便,今天学到这里,也碰到了很多问题,花时间深究下,做个学习笔记,希望能对初学者有帮助
    2011-12-12
  • php DES加密算法实例分析

    php DES加密算法实例分析

    这篇文章主要介绍了php DES加密算法,结合实例形式分析了yii框架的DES加密算法类定义,以及兼容C#和java的3DES加密算法实现技巧,需要的朋友可以参考下
    2019-09-09
  • php简单静态页生成过程

    php简单静态页生成过程

    一直用smarty的cache,但感觉还是要自己做一个,才有感觉。网上有很多牛人的功能比较完备,打算先自己搞简单的再慢慢丰满。这两天做了一个比较简单的,在hi.baidu.net/alex_wang58记录一下。
    2008-03-03

最新评论