利用Python开发微信支付的注意事项


Posted in Python onAugust 19, 2016

前言

微信支付是由微信及财付通联合推出的移动支付创新产品。如今,随着微信支付的全面开放,相关需求也越来越多,很多开发人员进行微信支付开发及商家申请微信支付时,面临着诸多疑惑。

要想开发顺利进行,首先要对业务流程有个清晰的认识。这里以微信公众号支付为例,因此也借用微信支付官方文档中的业务流程图:

利用Python开发微信支付的注意事项

接下来来关注几个开发过程中的关键点,包括:

      1、生成商户订单与调用统一下单 API

      2、微信服务器交互的数据格式

      3、公众号支付下网页内通过 JS-API 调起支付

      4、异步通知商户支付结果(回调) 

一、生成商户订单与调用统一下单 API

这对应业务流程中的第 4 和 第 5 步,商户后台首先为用户生成订单,然后调用微信的【统一下单】接口向微信支付系统提交订单。这里有一个关键点就是签名的生成

简单来讲分为以下几个步骤:

      1、将所有有效参数以“k=v”的形式进行拼接,有效参数是指非空参数,也就是说如果参数为空,则不参与签名;

      2、将所有的“k=v”对用“&”连接,得到“k1=v1&k2=v2&k3=v3”这样的字符串;

      3、将微信支付 API 密钥 拼接在最后,如“k1=v1&k2=v2&k3=v3&key=secret”;

      4、对整体进行 MD5 运算,即得到签名。

这种签名方法有一个高大上的名字叫做 HMAC(Hash-based Message Authentication Code,基于哈希的消息码)。基于此思路,可以实现如下签名方法:

def gen_sign(params, key):
  """
  签名生成函数
 
  :param params: 参数,dict 对象
  :param key: API 密钥
  :return: sign string
  """
 
  param_list = []
  for k in sorted(params.keys()):
    v = params.get(k)
    if not v:
      # 参数的值为空不参与签名
      continue
    param_list.append('{0}={1}'.format(k, v))
  # 在最后拼接 key
  param_list.append('key={}'.format(key))
  # 用 & 连接各 k-v 对,然后对字符串进行 MD5 运算
  return md5('&'.join(param_list).encode('utf8')).hexdigest()

参与签名的参数中有一个随机字符串,在 Python 中有很多方法,当然也可以利用 uuid 库来生成:

def gen_nonce_str():
  """
  生成随机字符串,有效字符a-zA-Z0-9
 
  :return: 随机字符串
  """
 
  return ''.join(str(uuid.uuid4()).split('-'))

 

二、微信服务器交互的数据格式

微信服务器与商户服务器之间采用 XML 格式进行交互,这就涉及到与语言原生数据类型进行转换以方便处理。交互的数据参数都是 key-value 的形式,因此在 Python 中使用字典会更加方便。而要解析 XML,也有一大把第三方库供使用,比如 BeautifulSoup

以下是具体实现:

def trans_xml_to_dict(xml):
  """
  将微信支付交互返回的 XML 格式数据转化为 Python Dict 对象
 
  :param xml: 原始 XML 格式数据
  :return: dict 对象
  """
 
  soup = BeautifulSoup(xml, features='xml')
  xml = soup.find('xml')
  if not xml:
    return {}
 
  # 将 XML 数据转化为 Dict
  data = dict([(item.name, item.text) for item in xml.find_all()])
  return data
 
 
def trans_dict_to_xml(data):
  """
  将 dict 对象转换成微信支付交互所需的 XML 格式数据
 
  :param data: dict 对象
  :return: xml 格式数据
  """
 
  xml = []
  for k in sorted(data.keys()):
    v = data.get(k)
    if k == 'detail' and not v.startswith('<![CDATA['):
      v = '<![CDATA[{}]]>'.format(v)
    xml.append('<{key}>{value}</{key}>'.format(key=k, value=v))
  return '<xml>{}</xml>'.format(''.join(xml))

注意 detail 参数,即商品详情,其值为 JSON 格式,在转换为 XML 数据时应前注意使用 CDATA 标签将其保护起来。

如:

<detail><![CDATA[{"goods_detail": [{"wxpay_goods_id": "10010001", "price": 1, "goods_num": 1, "goods_name": "\\u82f9\\u679c", "goods_id": "10010001"}, {"wxpay_goods_id": "10010002", "price": 1, "goods_num": 1, "goods_name": "\\u9999\\u8549", "goods_id": "10010002"}]}]]></detail>

三、公众号支付下网页内通过 JS-API 调起支付

这一点对应业务流程中的第 7 步。之所以提及它是因为微信官方文档在此给开发者挖了一个坑(至少截至我在写这篇文章时是的),就是在“网页端调起支付API”中关于 JS 的示例代码是采用的 WeixinJSBridge,这在很早以前就是 Deprecated 的“玩意儿”,如今更是已经不可用了。正确的做法是使用 JS-SDK,可以参考微信公众号的 wiki。

使用 JS-SDK 前需要先调用 config,这里也包含一个签名,但注意这个签名与之前微信支付的签名并不相干。其首先需要用微信公众号的 APPID 和 APPKEY 来换取 access_token,然后用该 access_token 调用 JS-SDK 换取 ticket 的接口得到 ticket,最后再使用该 ticket 和用户当前页面的 URI 通过 sha1 运算生成签名。

在此之后,即可调用 wx.chooseWXPay 来调起支付,这里也有一个坑:timestamp。wx.chooseWXPay 中的参数要求 timestamp 是全小写。而微信支付中签名时要求 timestamp 中的“s”是大写。真的是要傻傻分不清了。 

四、异步通知商户支付结果(回调)

最后是关于异步回调,对应业务流程中的第 10 步。在用户支付操作完成后,微信服务器会通过回调的形式告知商户服务器支付结果。回调的地址与【统一下单】中定义的 notify_url 一致。当接收到回调时,首先应验证签名的有效性以保证“来源可靠”,然后可以通过回调中所带的 openid、out_trade_no 等来定位唯一订单。

总结

微信支付还有很多种形式,在业务流程上也不尽相同。不过只要能玩转其中一种,其他的也基本来说能很快实现。另外,支付功能的实现涉及业务流程中的安全性,因此一定要注意理清业务流程,并卡好各个关键结点。以上就是本文的全部内容,希望对大家使用Python开发微信支付能有所帮助。

Python 相关文章推荐
Python minidom模块用法示例【DOM写入和解析XML】
Mar 25 Python
python实现电子书翻页小程序
Jul 23 Python
在django admin中添加自定义视图的例子
Jul 26 Python
Python3显示当前时间、计算时间差及时间加减法示例代码
Sep 07 Python
python数据化运营的重要意义
Nov 25 Python
python定义类self用法实例解析
Jan 22 Python
解决Pycharm 中遇到Unresolved reference 'sklearn'的问题
Jul 13 Python
Python根据字典的值查询出对应的键的方法
Sep 30 Python
selenium判断元素是否存在的两种方法小结
Dec 07 Python
Python使用sql语句对mysql数据库多条件模糊查询的思路详解
Apr 12 Python
Python os和os.path模块详情
Apr 02 Python
Python Matplotlib绘制等高线图与渐变色扇形图
Apr 14 Python
Python用模块pytz来转换时区
Aug 19 #Python
教你用python3根据关键词爬取百度百科的内容
Aug 18 #Python
利用Python爬取可用的代理IP
Aug 18 #Python
总结用Pdb库调试Python的方式及常用的命令
Aug 18 #Python
Python实现命令行通讯录实例教程
Aug 18 #Python
Python采用Django开发自己的博客系统
Sep 29 #Python
浅析Python中元祖、列表和字典的区别
Aug 17 #Python
You might like
php的一些小问题
2010/07/03 PHP
php输出表格的实现代码(修正版)
2010/12/29 PHP
zf框架的registry(注册表)使用示例
2014/03/13 PHP
php实现批量压缩图片文件大小的脚本
2014/07/04 PHP
php array_slice 取出数组中的一段序列实例
2016/11/04 PHP
laravel创建类似ThinPHP中functions.php的全局函数
2016/11/26 PHP
PHP数据库处理封装类实例
2016/12/24 PHP
用js模拟struts2的多action调用示例
2014/05/19 Javascript
js锁屏解屏通过对$.ajax进行封装实现
2014/07/31 Javascript
js实现点击链接后窗口缩小并居中的方法
2015/03/02 Javascript
jQuery仿天猫实现超炫的加入购物车
2015/05/04 Javascript
AngularJS Ajax详解及示例代码
2016/08/17 Javascript
关于javascript事件响应的基础语法总结(必看篇)
2016/12/26 Javascript
PHP实现记录代码运行时间封装类实例教程
2017/05/08 Javascript
js读取本地文件的实例
2017/12/22 Javascript
layui中table表头样式修改方法
2018/08/15 Javascript
vue组件实践之可搜索下拉框功能
2018/11/25 Javascript
Angular8路由守卫原理和使用方法
2019/08/29 Javascript
ant-design-vue按需加载的坑的解决
2020/05/14 Javascript
基于vue-simple-uploader封装文件分片上传、秒传及断点续传的全局上传插件功能
2021/02/23 Vue.js
vue实现拖拽进度条
2021/03/01 Vue.js
Pycharm+Python+PyQt5使用详解
2019/09/25 Python
Python3 Tensorlfow:增加或者减小矩阵维度的实现
2020/05/22 Python
Kmeans均值聚类算法原理以及Python如何实现
2020/09/26 Python
html5 音乐播放器 audio 标签使用概述
2013/07/15 HTML / CSS
美国第一大药店连锁机构:Walgreens(沃尔格林)
2019/10/10 全球购物
Haggar官网:美国男装品牌
2020/02/16 全球购物
C,C++的几个面试题小集
2013/07/13 面试题
初中生期末考试的自我评价
2013/12/17 职场文书
2014庆六一活动方案
2014/03/02 职场文书
2014年科协工作总结
2014/12/09 职场文书
公司宣传语大全
2015/07/13 职场文书
初中毕业感言300字
2015/07/31 职场文书
PHP实现两种排课方式
2021/06/26 PHP
Unicode中的CJK(中日韩统一表意文字)字符小结
2021/12/06 HTML / CSS
Pandas实现批量拆分与合并Excel的示例代码
2022/05/30 Python