new: dev: 加入微信刷卡支付功能，加入使用说明及example

*加入功能：微信刷卡支付，详见https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapt
er=9_10&index=1
*example.py中补充刷卡支付功能的调用实例
*README.md中补充刷卡支付功能的介绍
*检查全部功能还可以正常使用，微信没有对其他接口进行更改。
——2017/05/19

Author: Jolly23

README.md

@@ -114,12 +114,23 @@
         # 如果check_name为True，下面re_user_name必须传入
         # 如果check_name为False，请删除下一行参数re_user_name
         re_user_name=u'***客户的真实姓名***',  # 校验不成功付款会是失败
-        amount=100,  # total_fee 单位是 分， 100 = 1元, 单用户 单笔上限／当日上限：2W／2W
+        amount=100,  # amount 单位是 分， 100 = 1元, 单用户 单笔上限／当日上限：2W／2W
         desc=u'充值失败退款', # 付款原因
         spbill_create_ip='222.222.222.222',  # 调用微信企业付款接口服务器公网IP地址
     )
 ```
 
+提交刷卡支付请求（通过微信钱包付款码的方式付款）
+商户需可通过 设备扫码 等方式获取到客户付款码，向微信提交支付请求
+```python
+    wx_pay.swiping_card_payment(
+        body=u'***商品名称/付款显示名称***',  # 例如：综合超市
+        total_fee=100,  # total_fee 单位是 分， 100 = 1元, 单用户 单笔上限／当日上限：2W／2W
+        auth_code='131336161431593669', # 扫码支付授权码，设备读取用户微信中的条码或者二维码信息（注：用户刷卡条形码规则：18位纯数字，以10、11、12、13、14、15开头）
+        spbill_create_ip='222.222.222.222',  # 调用微信企业付款接口服务器公网IP地址
+    )
+```
+
 ## 工具函数
 
 签名

example.py

@@ -1,9 +1,10 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
-from flask import jsonify
-from time import time
 from hashlib import sha1
+from time import time
+
+from flask import jsonify
 
 from wx_pay import WxPay, WxPayError
 
@@ -190,12 +191,30 @@ def enterprise_payment_to_wallet():
         # api_cert_path: 微信支付商户证书（apiclient_key.pem）的本地保存路径
         api_key_path='/home/xxx/SERVER/ext_file/apiclient_key.pem',
         openid=u'***to_user_openid***',  # 要接收转账的用户openid
-        check_name=True,    # 是否强制校验收款用户姓名
+        check_name=True,  # 是否强制校验收款用户姓名
         # 如果check_name为True，下面re_user_name必须传入
         # 如果check_name为False，请删除下一行参数re_user_name
         re_user_name=u'***客户的真实姓名***',  # 校验不成功付款会是失败
         amount=100,  # total_fee 单位是 分， 100 = 1元, 单用户 单笔上限／当日上限：2W／2W
-        desc=u'充值失败退款', # 付款原因
+        desc=u'充值失败退款',  # 付款原因
+        spbill_create_ip='222.222.222.222',  # 调用微信企业付款接口服务器公网IP地址
+    )
+
+
+def swiping_card_example():
+    """
+       刷卡支付 example
+    """
+    wx_pay = WxPay(
+        wx_app_id='WX_APP_ID',
+        wx_mch_id='WX_MCH_ID',
+        wx_mch_key='WX_MCH_KEY',
+        wx_notify_url='http://www.example.com/pay/weixin/notify'
+    )
+    wx_pay.swiping_card_payment(
+        body=u'***商品名称/付款显示名称***',  # 例如：综合超市
+        total_fee=100,  # total_fee 消费金额 单位是 分
+        auth_code='131336161431593669',  # 获取到的客户微信付款码
         spbill_create_ip='222.222.222.222',  # 调用微信企业付款接口服务器公网IP地址
     )
 

wx_pay.py

@@ -1,9 +1,10 @@
 # -*- coding: utf-8 -*-
-import time
-import string
-import random
 import hashlib
+import random
+import string
+import time
 import urllib2
+
 import requests
 
 try:
@@ -400,3 +401,45 @@ def enterprise_payment(self, api_cert_path, api_key_path, **data):
         if raw["return_code"] == "FAIL":
             raise WxPayError(raw["return_msg"])
         return raw
+
+    def swiping_card_payment(self, **data):
+        """
+        提交刷卡支付
+        详细规则参考 https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=9_10&index=1
+
+        :param data: body, out_trade_no, total_fee, auth_code, (可选参数 device_info, detail, goods_tag, limit_pay)
+            body: 商品描述
+            *out_trade_no: 商户订单号
+            total_fee: 标价金额, 整数, 单位 分
+            auth_code: 微信支付二维码扫描结果
+            *device_info: 终端设备号(商户自定义，如门店编号)
+            user_ip 在flask框架下可以自动填写, 非flask框架需传入spbill_create_ip
+        :return: 统一下单生成结果
+        """
+        url = "https://api.mch.weixin.qq.com/pay/micropay"
+
+        # 必填参数
+        if "body" not in data:
+            raise WxPayError(u"缺少刷卡支付接口必填参数body")
+        if "total_fee" not in data:
+            raise WxPayError(u"缺少刷卡支付接口必填参数total_fee")
+        if "out_trade_no" not in data:
+            data.setdefault("out_trade_no", self.nonce_str())
+
+        user_ip = self.user_ip_address()
+        if not user_ip and "spbill_create_ip" not in data:
+            raise WxPayError(u"当前未使用flask框架，缺少刷卡支付接口必填参数spbill_create_ip")
+
+        data.setdefault("appid", self.WX_APP_ID)
+        data.setdefault("mch_id", self.WX_MCH_ID)
+        data.setdefault("nonce_str", self.nonce_str())
+        data.setdefault("spbill_create_ip", user_ip)
+        data.setdefault("sign", self.sign(data))
+
+        raw = self.fetch(url, data)
+        if raw["return_code"] == "FAIL":
+            raise WxPayError(raw["return_msg"])
+        err_msg = raw.get("err_code_des")
+        if err_msg:
+            raise WxPayError(err_msg)
+        return raw