小程序微信支付功能配置方法示例详解【基于thinkPHP】


Posted in PHP onMay 05, 2019

本文实例讲述了小程序微信支付功能配置方法。分享给大家供大家参考,具体如下:

★ 背景

  • 近期进行小程序的开发,毕竟是商城项目的开发,最后牵扯到的微信支付是必要的
  • 个人开发过程中也是遇到各种问题,在此,我根据自己的实际操作,进行了代码的详细配置,以方便小程序新手的快速操作

-  使用语言:PHP             # PHP世界上最好的语言 HaHahahaaha
-  使用框架:ThinkPHP 3.2    # 版本有点低而已,没啥大碍
-  测试工具:微信开发者工具    # 其实还挺好用
-  整理时间:2018-07-07      # 有问题,就会一直更新

tip: 【代码都是可转化的,即便是 ThinkPHP5.0+ 还是 Laravel框架,相对熟悉 PHP 代码语法的,进行转化也只是分分钟的事哦!】

一、开发前的准备

①. 开发步骤

  • 如果开发者已做过 JSAPIJSSDK 调起微信支付,接入小程序支付非常相似,以下是三种接入方式的对比:
    小程序微信支付功能配置方法示例详解【基于thinkPHP】
  • 如此看来,小程序要想集成支付功能,倒是简单了
  • 对公众号微信支付感兴趣的可以参考之前整理的一篇文章 —— 微信公众平台开发教程④ ThinkPHP框架下微信支付功能图文详解

②. 阅读业务流程图

  • 本人强烈推荐阅读这个图示,流程明确了,代码逻辑自然也就理顺了!
    小程序微信支付功能配置方法示例详解【基于thinkPHP】

③. 小程序支付业务

  • 此处,小程序官方已做了详细说明 —— 业务说明

# 很多人这一步还没有完成,就咔咔咔的测试支付功能,显然是太急于求成了,比如:我!
> 注意:
> 1. 要开通微信支付功能(一般有两三天的审核时间)
> 2. 本人开通后,选择的是 “绑定一个已有的微信支付商户号”,也就几分钟的事

小程序微信支付功能配置方法示例详解【基于thinkPHP】

  • 此处请阅读官方文末的注意事项【重要】:

1 appid 必须为最后拉起收银台的小程序appid;
  # 这句话感觉不说还好,一说更容易引起多余的考虑(忽视)

2 mch_id 为和 appid 成对绑定的支付商户号,收款资金会进入该商户号;
  # 此处我直接使用了所绑定的商户号中的 mch_id

3 trade_type 请填写"JSAPI";
  # 可暂时忽略,因为我在代码中已进行了配置

4 openid 为 appid 对应的用户标识,即使用 "wx.login" 接口获得的 openid
  # 可参考我的 payment/index.js 代码
  # 另一种情况,如果项目数据库中已保存了该用户的openid字段,可自行获取

二、小程序端代码配置指导

  • 这里进行配置的代码,都在附录源码包的 wxMini-PayDemo\wxChat 目录下

为了项目代码的 通用性/易管理性,我自行提取出了两个主要的公共文件 config.js util.js;

①. utils下 config.js 文件的使用

  • config.js 文件中,主要就是配置一些公共访问路径之类的数据,方便后期代码上线后的链接更改
  • 所以,对于其中的 restUrlimgServer 修改为自己的服务器地址即可
    小程序微信支付功能配置方法示例详解【基于thinkPHP】

> 注意一点:
我的 "restUrl" 是对应于我的小程序 Api 接口路径的,举个例子:
我的支付回调路径为 "https://www.mySercver.com/WxApi/Pay/notify"

②. utils下 util.js 文件的使用

  • 这个是和 config.js 文件在同一目录下的公共文件
  • 其实就是整合了三个主要的方法,需要注意的是:如果你有所补充,记得在文件的最后进行 “exports” 输出就好
module.exports = {
 http_get: http_get,
 http_post: http_post,
 showToast: showToast,
}

③. payment/index.js 文件的使用

  • 此文件作为 小程序微信支付前端的核心文件
  • 在保证你的各个文件目录对应配置正确的情况下,只需在进行支付唤醒时,调用其中的 btnClickToPay() 方法即可:
    小程序微信支付功能配置方法示例详解【基于thinkPHP】
  • 当然,我只是随便定的一个方法,实际使用的时候,其实就是以类似的形式,去调用后面的 wxPay()方法呗!

三、服务端代码文件的使用指导

  • 这里进行配置的代码,都在源码包的 wxMini-PayDemo\Server-PHP 目录下

声明:
***因为本人所提供的代码是基于 ThinkPHP3.2 框架编写整理的,所以对于使用过 ThinkPHPLaravel 框架的 PHPer 来说,简单明了,可根据自己的框架进行调整适配,所以,此处讲的可能不会太过琐碎 ***

①. 公共配置文件的数据补充

  • 此为源代码中的 "wxMini-PayDemo\Server-PHP\Conf\config.php",此文件代码比较少,我直接进行展示:
return array(
 //'配置项'=>'配置值'
 'wxPay' => [
 'appid' => 'wx8787xxxxxxxxxxxxx',//TODO 此处使用的是小程序的 APPID
 'app_secret' => '0a7xxxxxxxxxxxxxxxxxxxxxxxxxxxxx622', //小程序的应用密钥
 'pay_mchid' => '13xxxxxx02', // 微信支付MCHID 商户收款账号
 'pay_apikey' => '1qaxxxxxxxxxxxxxxxxxxxxxhgf5', // 微信支付KEY
 'notify_url' => 'https://www.mySercver.com/WxApi/Pay/notify', // 微信支付成功后进行回调的链接
 'login_url' => "https://api.weixin.qq.com/sns/jscode2session?" .
  "appid=%s&secret=%s&js_code=%s&grant_type=authorization_code", // 微信使用code换取用户openid及session_key的url地址
 ],
);
  • 对于上述配置信息的来源,应该没啥疑问吧?

注意一点:
"notify_url" 作为支付回调的链接地址,要求配置成自己的服务器路径
 ;#同时注意协议的要求 “https”

小程序官方要求:
 ;# 需要进行服务器域名的配置
 ;# 操作位置为 “小程序(微信公众平台)/设置/开发设置”中的“服务器域名->request 合法域名”

小程序微信支付功能配置方法示例详解【基于thinkPHP】

②. 公共方法 function.php 的补充

  • 对于本人的逻辑处理中,其实只有一个方法 curl_get(), 并且只在 PayController.class.phpgetOpenID() 方法中进行了一次调用,也可以自行提取使用的
    小程序微信支付功能配置方法示例详解【基于thinkPHP】

③. 核心处理文件 PayController.class.php

此文件代码已做了详细处理,在你正确放置后,需要注意的几点如下:

  • (1). 注意命名空间 "namespace" 与自己业务代码的对应
  • (2). 在 "prepay()" 方法中,因为不同的业务都会有属于自己的判断处理逻辑,
    小程序微信支付功能配置方法示例详解【基于thinkPHP】

所以,在使用时完全可以替换掉所调用的 "prepayOrderDeal()" 方法  ;# 相信没多大歧义吧!
   #【在此处,我建议进行一下微信支付金额的校对】
   # 比如,通过订单号到你的项目数据库中,查询出需要支付的金额再与此比较,
   # 只有符合你的要求才可以进行微信支付的下单操作

  • (3). 在 "pay()" 方法中

建议对应当前的订单号,保存微信支付返回的 prepay_id

小程序微信支付功能配置方法示例详解【基于thinkPHP】

  • (4). 再有就是,在 "notify()" 这个回调方法中

一定会涉及到自己业务的更新处理逻辑
    所以被调用的 "payNotifyOrderDeal()"方法中就可以改成你自己的业务逻辑了 (此处是可以自行补充的)

小程序微信支付功能配置方法示例详解【基于thinkPHP】

 注意,此处传入的 "$result" 参数中,我主要使用的就是其中的 "out_trade_no" 和 "total_fee"
  # 包含着微信支付的众多信息,可自行提取
 前者用于匹配我对该已支付订单的后续更新操作
  #【提示:我在使用时需要使用 "M" 进行字符串的截取才是我自己业务的实际订单编号哦!】;
 后者是实际微信消费的金额,可用于数据表的记录,以方便对账人员的校对工作

补充:
  1. 为了方便后期 微信退款功能 的扩展,建议对应订单保存回调得到的 $result
  2. 可以将其转化为 json 字符串形式 $wx_pay_result_json = json_encode($result);, 然后存储在订单表中,比如:
    小程序微信支付功能配置方法示例详解【基于thinkPHP】
  3. 如果,直接进行微信退款功能的实现,请完成后,参考:小程序 微信退款功能实现讲解 (PHP方式)

四、使用及测试效果

①. 测试效果

  • 在我的小程序项目中,唤醒的效果(开发工具中)如下:
    小程序微信支付功能配置方法示例详解【基于thinkPHP】

  • 如果是在自己的手机端进行测试,在保证你的域名配置正确的情况下,唤醒的样式就是常见的样子:
    -小程序微信支付功能配置方法示例详解【基于thinkPHP】

②. 补充说明

- 相信在实际配置使用的过程中一定会出现各种问题,我也是一点点的梳理排错过来的 - 前面的多是些配置问题的规范,如果到了最后的唤醒阶段,出现的问题要注意查看开发工具的控制台, - 其中会有比较详细的报错信息,然后再进行排查解决 - 有何问题,欢迎指摘,祝你配置顺利咯!

☆ 附录:

①. >>> Github 源码下载参考

再做补充:如果,直接进行微信退款功能的实现,请完成后,参考:小程序 微信退款功能实现讲解 (PHP方式)

②. 总结

  • 通过对以上操作的梳理,可以提取出主要的几个步骤:

- . 小程序要开通你的微信支付功能 # 需要审核时间的
- . 审核通过后,紧接着进行"开通"操作 #可有两种开通方式进行选择的
- . 前后端重要信息配置完毕
- . 补充自己的特有逻辑处理操作 #pay/prepayOrderDeal()和 pay/payNotifyOrderDeal()
- . 支付回调成功后,进行后续的订单(项目服务器)查询操作

希望本文所述对大家基于ThinkPHP框架的PHP程序设计有所帮助。

PHP 相关文章推荐
php函数之子字符串替换 str_replace
Mar 23 PHP
修改PHP的memory_limit限制的方法分享
Feb 21 PHP
PHP四大安全策略
Mar 12 PHP
php操作XML、读取数据和写入数据的实现代码
Aug 15 PHP
ThinkPHP添加更新标签的方法
Dec 05 PHP
9个实用的PHP代码片段分享
Jan 22 PHP
PHP Hash算法:Times33算法代码实例
May 13 PHP
DEDECMS首页调用图片集里的多张图片
Jun 05 PHP
PHP实现通过正则表达式替换回调的内容标签
Jun 15 PHP
PHP+Session防止表单重复提交的解决方法
Apr 09 PHP
thinkPHP框架整合tcpdf插件操作示例
Aug 07 PHP
解决thinkphp5未定义变量会抛出异常,页面错误,请稍后再试的问题
Oct 16 PHP
php实现的顺序线性表示例
May 04 #PHP
TP5.0框架实现无限极回复功能的方法分析
May 04 #PHP
PHP7 mongoDB扩展使用的方法分享
May 02 #PHP
PHP超低内存遍历目录文件和读取超大文件的方法
May 01 #PHP
Yii框架学习笔记之session与cookie简单操作示例
Apr 30 #PHP
YII框架学习笔记之命名空间、操作响应与视图操作示例
Apr 30 #PHP
YII框架关联查询操作示例
Apr 29 #PHP
You might like
《星际争霸重制版》兵种对比图鉴
2020/03/02 星际争霸
php中的观察者模式
2010/03/24 PHP
PHP 魔术函数使用说明
2010/05/14 PHP
phpMyAdmin 链接表的附加功能尚未激活问题的解决方法(已测)
2012/03/27 PHP
PHP获取windows登录用户名的方法
2014/06/24 PHP
PHP查找数值数组中不重复最大和最小的10个数的方法
2015/04/20 PHP
编写PHP脚本使WordPress的主题支持Widget侧边栏
2015/12/14 PHP
ThinkPHP项目分组配置方法分析
2016/03/23 PHP
php实现批量上传数据到数据库(.csv格式)的案例
2017/06/18 PHP
php 使用 __call实现重载功能示例
2019/11/18 PHP
JavaScript中的prototype使用说明
2010/04/13 Javascript
检测input每次的输入是否合法遇到汉字输入就有问题
2012/05/23 Javascript
jquery分页对象使用示例
2014/04/01 Javascript
ECMAScript6轮播图实践知识总结
2016/08/17 Javascript
JS简单实现仿百度控制台输出信息效果
2016/09/04 Javascript
JS实现的base64加密解密操作示例
2018/04/18 Javascript
如何从0开始用node写一个自己的命令行程序
2018/12/29 Javascript
浅谈vue限制文本框输入数字的正确姿势
2019/09/02 Javascript
Vue路由对象属性 .meta $route.matched详解
2019/11/04 Javascript
浅谈vue权限管理实现及流程
2020/04/23 Javascript
微信小程序开发之获取用户手机号码(php接口解密)
2020/05/17 Javascript
JavaScript实现雪花飘落效果
2020/12/27 Javascript
使用cx_freeze把python打包exe示例
2014/01/24 Python
Python语言描述连续子数组的最大和
2018/01/04 Python
解决pycharm无法识别本地site-packages的问题
2018/10/13 Python
详解Python发送email的三种方式
2018/10/18 Python
使用Pycharm(Python工具)新建项目及创建Python文件的教程
2020/04/26 Python
Python爬虫实现百度翻译功能过程详解
2020/05/29 Python
java关于string最常出现的面试题整理
2021/01/18 Python
Canvas系列之滤镜效果
2019/02/12 HTML / CSS
蛋白质世界:Protein World
2017/11/23 全球购物
老师的检讨书
2014/02/23 职场文书
高等教育学专业自荐书
2014/06/17 职场文书
员工激励培训演讲稿
2014/09/16 职场文书
2015迎新晚会活动总结
2015/07/16 职场文书
初一语文教学反思
2016/03/03 职场文书