ThinkPHP框架下整合支付宝支付功能图文教程
作者:moTzxx
本文实例讲述了ThinkPHP框架下整合支付宝支付功能。分享给大家供大家参考,具体如下:
背景
- 近期项目需要接入支付宝支付功能,其中开发使用了ThinkPHP3.2.3框架,通过参考开发平台文档可以知道,网站开发有两种场景,一种是手机网站支付,直接唤醒支付宝app进入支付操作;另一种多是 PC 端显示支付二维码的形式,然后使用手机的支付宝app扫描。
- 此处主要介绍手机网站支付的实现,后期补充扫码支付。
一.接入配置
1).接入步骤
根据“快速接入”中的流程,两者大同小异,都是进行:
- 第一步:创建应用并获取APPID
- 第二步:配置密钥
- 第三步:搭建和配置开发环境
- 第四步:调用接口
2).配置截图
3).提示说明
虽然官方文档已经做的很详细、成熟,不过还是有几点需要着重提醒一下,以免不必要的纠结。
- 应用创建成功后需要大概一到三天的审核
- 配置密钥时建议下载其提供的加密工具,可参考RSA密钥生成方法
- 此处我所下载的是开发平台服务端SDK中的PHP版资源,而非DEMO文件,相信两者还是有所区别的
二.手机网站支付接口实现
1).测试入口页面
如下图所示,我在此创建了一个简单的入口文件,根据开发文档中的介绍是需要统一编码格式的,此处我选择的是UTF-8
2).html代码参考
需要注意的是,接口指明需要POST方式进行提交请求
3).支付宝配置信息
对于支付宝的配置信息,我写在 Application/Common/Conf/config.php中
//支付宝 支付配置 'ALI_CONFIG' => array( 'gatewayUrl' => 'https://openapi.alipay.com/gateway.do',//支付宝网关(固定)' 'appId' => '2017xxxxxxxx9',//APPID即创建应用后生成 //由开发者自己生成: 请填写开发者私钥去头去尾去回车,一行字符串 'rsaPrivateKey' => 'MIIExxxxxxxxxxxxxxxxxxxxxxxxxxxq', //支付宝公钥,由支付宝生成: 请填写支付宝公钥,一行字符串 'alipayrsaPublicKey' => 'IIBxxxxxxxxxxxxxxxxxxxEFAA', 'notifyUrl' => 'http://www.xxx.com/m/cartpay/notify_ali', // 支付成功通知地址 'returnUrl' => 'http://www.xxx.com', // 支付后跳转地址 'returnPcUrl' => 'http://www.xxx.com/Home', // PC端扫码支付后跳转地址 ),
4).服务端SDK导入
将前面所下载的SDK放入自定义的位置,在此,我习惯放在如下的路径中,…\ThinkPHP\Library\Vendor\Alipay,特别提醒一点,对于各文件类的引用会依据代码框架而不同,需要自行确认。
5).支付接口实现
在请求唤醒支付宝支付的路径中进行接口代码的编辑
提示
- 通过实验发现,如果在电脑端进行此功能的支付测试,会报出如下的类似错误,个人认为源于手机和PC的内置配置不同
- 对于手机网站支付需要在手机上测试,可自行配置虚拟域名手机访问即可,不要在此问题上花费不必要的时间
- 因为本人就是在电脑有报错,手机端访问却能完美实现,从而走了验证签名的过程到最后却并非错在签名,当然也不排除你的操作过程签名一定是没问题的哦.
代码实现如下:
/** * 支付宝支付post提交页面 */ public function alipay(){ if (IS_POST){ Vendor('Alipay.aop.AopClient'); Vendor('Alipay.aop.request.AlipayTradeWapPayRequest'); //$out_trade_no = I('post.order_sn'); /* * $out_trade_no 为自己业务逻辑中要支付的订单号 * 可从POST数据中提取,具体安全起见可自行加密操作 此处仅举例测试数据 * $order_amount 为要进行支付的金额 注意要用小数转换 * 例如:3.50,10.00 * $aliConfig 获取支付宝配置数据 */ $out_trade_no = '2017M'.time(); $body = '欢迎购买商品,愿您购物愉快'; $subject = '你好'; $order_amount = 9.00; $aliConfig = C('ALI_CONFIG'); $aop = new \AopClient(); $aop->gatewayUrl = $aliConfig['gatewayUrl']; $aop->appId = $aliConfig['appId']; $aop->rsaPrivateKey = $aliConfig['rsaPrivateKey']; $aop->alipayrsaPublicKey=$aliConfig['alipayrsaPublicKey']; $aop->apiVersion = '1.0'; $aop->postCharset='UTF-8'; $aop->format='json'; $aop->signType='RSA2'; $request = new \AlipayTradeWapPayRequest (); $bizContent = "{" . " \"body\":\"$body.\"," . " \"subject\":\"$subject\"," . " \"out_trade_no\":\"$out_trade_no\"," . " \"timeout_express\":\"90m\"," . " \"total_amount\":$order_amount," . " \"product_code\":\"QUICK_WAP_WAY\"" . " }"; $request->setBizContent($bizContent); $request->setNotifyUrl($aliConfig['notifyUrl']); $request->setReturnUrl($aliConfig['returnUrl']); $result = $aop->pageExecute ( $request); echo $result; }else{ echo 'sorry,非法请求失败'; } }
6).支付成功后的通知处理
此时,通过获取所提交过来的post数据,进行订单号的剥离,从而进行下一步的业务逻辑处理即可.
[注意]:
- 接口文档中有点明,支付通知功能最后需要输出‘success'
- 此处的通知路径要与配置中确定的 ‘notifyUrl'完全一致
/** * 支付宝支付通知功能 */ public function notify_ali(){ $out_trade_no = I('post.out_trade_no'); $this->toUpdatePayInfo($out_trade_no,'ali'); echo 'success'; }
三.电脑网站支付接口实现
对比来看,其实 PC 端的代码设计与手机端大同小异,在此点明一下使用情景,可进行参考。
1).支付接口实现
提示:
测试发现,接口中定义“subject”时,对于文字的数目有要求,不能超过四个字,至于字母似乎没有特别限制,开发过程中原想显示全部的商品名称却无法实现,还请注意。
提供的代码暂时未进行界面的设计,可参考 手机端接口思想,接收并处理订单信息后再唤醒支付宝,当前的代码可以在公共文件配置正确的情况下,直接公网访问接口链接即可展示效果。
支付成功后的通知处理,请参考手机端实现方式.
2).实现效果截图
3).代码实现如下:
/** * 电脑端唤醒 支付宝扫码支付接口 */ public function aliPayPage(){ $out_trade_no = '2017PC'.time(); $order_amount = '12.88'; $proName = "真米黑米 XXXXXX"; Vendor('Alipay.aop.AopClient'); Vendor('Alipay.aop.request.AlipayTradePagePayRequest'); //构造参数 $aop = new \AopClient(); $aliConfig = C('ALI_CONFIG'); $aop->gatewayUrl = $aliConfig['gatewayUrl']; $aop->appId = $aliConfig['appId']; $aop->rsaPrivateKey = $aliConfig['rsaPrivateKey']; $aop->apiVersion = '1.0'; $aop->signType = 'RSA2'; $aop->postCharset= 'utf-8'; $aop->format='json'; $request = new \AlipayTradePagePayRequest (); $request->setReturnUrl($aliConfig['returnPcUrl']); $request->setNotifyUrl($aliConfig['notifyUrl']); $request->setBizContent( "{" . " \"product_code\":\"FAST_INSTANT_TRADE_PAY\"," . " \"subject\":\"$proName\"," . " \"out_trade_no\":\"$out_trade_no\"," . " \"total_amount\":$order_amount," . " \"body\":\"Iphone6 16G\"" . " }"); //请求 $result = $aop->pageExecute ($request); //输出 echo $result; }
附录:
更多关于thinkPHP相关内容感兴趣的读者可查看本站专题:《ThinkPHP入门教程》、《thinkPHP模板操作技巧总结》、《ThinkPHP常用方法总结》、《codeigniter入门教程》、《CI(CodeIgniter)框架进阶教程》、《Zend FrameWork框架入门教程》及《PHP模板技术总结》。
希望本文所述对大家基于ThinkPHP框架的PHP程序设计有所帮助。