Laravel 支付解决方案之如何使用银联支付进行支付


Laravel中使用银联支付

上一节我们讨论了在Laravel中如何使用支付宝进行支付,这一节我们讲另一种常见的支付方式:银联支付。通过上一节的学习想必大家已经了解了OmniPay这个牛逼的GitHub项目,也对如何使用OmniPay for Laravel 5 & Lumen这个Laravel包有了大致的了解。没错,我们接下来要讲的银联支付还是使用这个Laravel包,并集成OmniPay提供的银联支付(UnionPay)接口——UmniPay UnionPay。

1、安装银联支付依赖包

废话不多说,下面直接切入正题。由于我们在上一节已经安装了ignited/laravel-omnipay这个包,这里我们只需要安装银联支付包即可:

  1. composer require lokielse/omnipay-unionpay dev-master

2、获取银联支付配置信息

到银联支付开发者中心注册账户并提交商户资料进行审核,等待审核通过后获取相关证书ID等信息用于填写银联支付配置选项。

如果你是测试的话银联支付提供了相应的测试接口和配置数据:银联支付测试配置信息

以及测试银行卡信息:

卡号 卡性质 机构名称 手机号码 密码 CVN2 有效期 证件号 姓名
6216261000000000018 借记卡 平安银行 13552535506 123456 341126197709218366 全渠道
6221558812340000 贷记卡 平安银行 13552535506 123456 123 1711 341126197709218366 互联网
短信验证码 111111

然后我们去https://open.unionpay.com/ajweb/help/file/techFile下载PHP版本的实例代码,比如我们这里测试的是网关支付,那就下载网关支付对应的实例代码,解压下载的压缩文件,然后将下面这个三个文件拷出来放到Laravel项目指定目录(比如storage/app/unionpay/certs):

银联支付验证文件

3、配置文件

配置config/laravel-omnipay.php(如果没有该配置文件参考上一节相应操作),添加银联支付配置:

  1. 'unionpay' => [
  2. 'driver' => 'UnionPay_Express',
  3. 'options' => [
  4. 'merId' => '777290058120462',
  5. 'certPath' => '/path/to/storage/app/unionpay/certs/PM_700000000000001_acp.pfx',
  6. 'certPassword' =>'000000',
  7. 'certDir'=>'/path/to/certs',
  8. 'returnUrl' => 'Your ReturnUrl Here',
  9. 'notifyUrl' => 'Your NotifyUrl Here'
  10. ]
  11. ]

4、基本使用

OmniPay UnionPay提供了以下支付网关接口:

  • Union_Express 银联全产品网关(PC,APP,WAP支付)
  • Union_LegacyMobile 银联老网关(APP)
  • Union_LegacyQuickPay 银联老网关(PC)

本例中我们使用Union_Express网关。

定义路由

  1. //银联支付处理
  2. Route::get('unionpay/pay','UnionpayController@pay');
  3. //支付后回调页面
  4. Route::post('unionpay/return','UnionpayController@result');

支付

新建控制器UnionPayController,定义pay方法:

  1. public function pay(){
  2.  
  3. $gateway = Omnipay::gateway('unionpay');
  4.  
  5. $order = [
  6. 'orderId' => date('YmdHis'),
  7. 'txnTime' => date('YmdHis'),
  8. 'orderDesc' => 'My test order title', //订单名称
  9. 'txnAmt' => '100', //订单价格
  10. ];
  11.  
  12. $response = $gateway->purchase($order)->send();
  13. $response->redirect();
  14. }

 

回调

定义result方法:

  1. public function result(){
  2.  
  3. $gateway = Omnipay::gateway('unionpay');
  4. $response = $gateway->completePurchase(['request_params'=>$_REQUEST])->send();
  5. if ($response->isPaid()) {
  6. exit('支付成功!');
  7. }else{
  8. exit('支付失败!');
  9. }
  10. }

此外,由于该回调请求来自第三方API,无法通过CSRF验证,所以需要在CSRF验证中排除该URL,否则会抛出TokenMismatchException异常,具体排除方法可参考CSRF攻击原理及其防护这篇教程,这里我们要排除的URL是unionpay/return

5、银联支付测试

在浏览中访问http://laravel.app:8000/unionpay/pay,页面会跳转到银联支付页面:

银联支付测试页面

我们将测试银行卡号填写到输入框并点击下一步:

银联支付测试页面

将测试卡号对应身份证号码填入输入框,然后点击“免费获取”,最后直接将手机验证码111111填写到验证码输入框,然后点击“确认付款”,页面就会跳转到支付成功页面:

银联支付测试成功页面

点击“返回商户”,则页面跳转到http://laravel.app:8000/unionpay/return并显示:

  1. 支付成功!

我们这里简单测试了支付和回调接口,更多接口方法使用请参考Omnipay: UnionPay。