4.微信支付之刷卡支付
实现微信支付刷卡支付
刷卡支付是用户展示钱包内的“刷微信卡条码/二维码”给商户系统，商户扫描后直接完成扣款。
主要应用线下面对面收银的场景，需要有扫描设备的支撑，最常见的莫过于扫码枪，但注意不能是激光扫码枪，因为这种枪因为反光的原因无法扫码手机上的条形码
使用场景
用户打开微信，进入”我”->“钱包”->“刷卡”，展示条形码的界面
收银台在商户系统操作生成支付订单，用户确认支付金额
收银员使用扫码枪扫码用户展示的条形码/二维码,获得条形码/二维码信息，商户系统使用刷卡支付接口提交支付
如果需要验密，手机端会弹出密码输入框要求用户输入密码；否则直接完成扣款
验密规则
支付金额>1000的交易需要输入密码
用户账户每天最多允许5笔免密交易，超过需要输入密码
微信支付后台判定用户行为有异常，符合免密规则的也要求输入密码
被扫支付接口
https://api.mch.weixin.qq.com/pay/micropay ，在package config里面为URL_MICROPAY变量
数据提交方式为post方式
数据格式为xml格式
开发流程
- 使用扫码备读设取微信用户刷卡授权码
- 将订单信息和授权码组成特定的xml数据格式，以post的方式提交的到接口地址（建议先传到商户自己的服务器，然后在商户的服务器端向接口以post的方式来提交支付，当然也可以在收银台发起，但不建议这样做，网络，安全在收银台都无法有效保障）
在上面向接口提交支付的时候，会返回对应的结果，分2种情况，一种是直接扣款，称为免密；一种是微信支付要求用户输入密码，称为验密
- 免密：返回支付结果，告知商户支付结果，成功或者失败。成功的话同时用户也会收到支付的通知，通过微信，短信的方式
- 验密：返回支付结果，返回的结果为USERPAYING状态，表示用户正在输入密码，此时商户可以每隔5秒，使用查询订单来查询该笔支付的结果
开发实现
刷卡支付实现中用到了package tools里面的微信支付签名，网络请求，生成随机字符串，请先去实现
签名代码，点击查看
网络请求代码，点击查看
生成随机字符串代码,点击查看
创建package micropay
创建文件夹micropay
创建支付请求数据，并实现签名以及请求发送
创建文件 micropayrequest.go，实现:
Mircopayrequest结构体：存储被扫支付需要提交的参数func (v *Mircopayrequest) Signmd5():对Mircopayrequest里面的非空字段进行签名，并存储签名func (v *Mircopayrequest) Xml():根据Mircopayrequest里面的非空字段，生成对应的xml格式数据，并存储该数据func (v Mircopayrequest) Dorequest():向被扫支付接口以post的请求方式发送生成的xml数据，并返回结果
代码实现
package micropay
import (
"encoding/xml"
"wechatpaygolang/config"
"wechatpaygolang/tools"
)
//1.创建Mircopayrequest结构体，存放我们的请求字段，带有 omitempty 表示该字段选填，其他的字段属于必填
type Mircopayrequest struct {
XMLName xml.Name `xml:"xml"` //表示xml数据格式
Appid string `xml:"appid"` //公众账号ID
Attach string `xml:"attach,omitempty"` //附加数据
Auth_code string `xml:"auth_code"` //授权码
Body string `xml:"body"` //商品描述
Device_info string `xml:"device_info,omitempty"` //设备号
Detail string `xml:"detail,omitempty"` //商品详情
Fee_type string `xml:"fee_type,omitempty"` //货币类型
Goods_tag string `xml:"goods_tag,omitempty"` //商品标记
Mch_id string `xml:"mch_id"` //商户号
Nonce_str string `xml:"nonce_str"` //随机字符串
Out_trade_no string `xml:"out_trade_no"` //商户订单号
Sign string `xml:"sign"` //签名
Spbill_create_ip string `xml:"spbill_create_ip"` //终端IP
Time_expite string `xml:"time_expite,omitempty"` //交易失效时间
Time_start string `xml:"time_start,omitempty"` //交易起始时间
Total_fee string `xml:"total_fee"` //总金额
RequestXML string `xml:"-"` //存放最终生成的xml请求数据,不参与签名以及xml的组成
}
//2.对Mircopayrequest里面的字段进行md5签名，存储到Mircopayrequest里面的Sign变量
func (v *Mircopayrequest) Signmd5() bool {
sign := tools.Wechatpay_SignMD5(*v, config.API_KEY)
v.Sign = sign
return true
}
//3.生成Mircopayrequest对应的xml数据，存储到Mircopayrequest里面的RequestXML变量
func (v *Mircopayrequest) Xml() error {
xmlresult, err := tools.XmlEndoestruct(v)
v.RequestXML = xmlresult
return err
}
//4.向刷卡接口发送post的请求，请求的数据为我们的生成存储在RequestXML变量的xml数据
// 并且将得到的数据解析到Mircopayresponse结构体
func (v Mircopayrequest) Dorequest() Mircopayresponse {
//发送post请求,f返回数据为data
data := tools.Post(config.URL_MICROPAY, v.RequestXML)
//解析data到Mircopayresponse结构体
mircopayresponse := Mircopayresponse{}
tools.XmlDecodebytes(data, &mircopayresponse)
mircopayresponse.ReponseXML = string(data)
//返回结果
return mircopayresponse
}
func value2CDATA(v string) CDATAText {
return CDATAText{""}
}
type CDATAText struct {
Text string `xml:",innerxml"`
}
创建支付结果数据
创建文件 micropayresponse.go，存储发起支付请求后的返回结果，实现代码如下
package micropay
import (
"encoding/xml"
)
//1.创建Mircopayresponse结构体，存放我们的请求字段，带有 omitempty 表示该字段选填，其他的字段属于必填,支付请求的结果会被解析到该结构体
type Mircopayresponse struct {
XMLName xml.Name `xml:"xml"`
Return_code string `xml:"return_code"` //返回状态码
Return_msg string `xml:"return_msg"` //返回信息
Appid string `xml:"appid"` //公众账号ID
Mch_id string `xml:"mch_id"` //商户号
Device_info string `xml:"device_info,omitempty"` //设备号
Nonce_str string `xml:"nonce_str"` //随机字符串
Sign string `xml:"sign"` //签名
Result_code string `xml:"result_code"` //业务结果
Err_code string `xml:"err_code"` //错误代码
Err_code_des string `xml:"err_code_des"` //错误代码描述
Is_subscribe string `xml:"is_subscribe"` //是否关注公众账号
Trade_type string `xml:"trade_type"` //交易类型
Bank_type string `xml:"bank_type"` //付款银行
Fee_type string `xml:"fee_type"` //货币类型
Total_fee string `xml:"total_fee"` //总金额
Cash_fee_type string `xml:"cash_fee_type"` //现金支付货币类型
Cash_fee string `xml:"cash_fee"` //现金支付金额
Coupon_fee string `xml:"coupon_fee"` //代金券或立减优惠金额
Transaction_id string `xml:"transaction_id"` //微信支付订单号
Out_trade_no string `xml:"out_trade_no"` //商户订单号
Attach string `xml:"attach"` //商家数据包
Time_end string `xml:"time_end"` //支付完成时间
ReponseXML string `xml:"-"` //结果xml串
}
发起支付
创建文件miropay.go,执行被扫支付操作,实现代码如下
package micropay
import (
"fmt"
"net/http"
"wechatpaygolang/config"
"wechatpaygolang/tools"
)
type Show struct {
Resault string
}
//1.执行刷卡支付功能入口
func Micropay(w http.ResponseWriter, r *http.Request) {
r.ParseForm()
//获得要支付的金额
fee := r.FormValue("fee")
//获取用户的刷卡二维码
authcode := r.FormValue("authcode")
//创建Mircopayrequest请求参数
v := &Mircopayrequest{Appid: config.APP_ID, Mch_id: config.MCH_ID}
v.Auth_code = authcode
if fee != "" {
v.Total_fee = fee
} else {
v.Total_fee = "1"
}
v.Body = "weixin"
v.Nonce_str = tools.Getnoncestr(32)
v.Out_trade_no = tools.Getnoncestr(32)
v.Spbill_create_ip = "127.0.0.1"
// v.Goods_tag = "das"
//对请求参数进行MD5签名，得到签名字串
v.Signmd5()
// v.Sign = "607642655893AF4616B3DC406E659F32"
//把请求参数转换为xml格式的数据
v.Xml()
fmt.Fprintf(w, "请求数据如下\n")
fmt.Fprintf(w, v.RequestXML+"\n\n\n\n")
//发起支付请求，并得到返回结果
response := v.Dorequest()
//输出支付结果信息
fmt.Printf("返回状态：%s \n", response.Return_code)
fmt.Printf("返回信息: %s \n", response.Return_msg)
fmt.Printf("业务结果: %s \n", response.Result_code)
fmt.Printf("错误代码: %s \n", response.Err_code)
fmt.Printf("错误代码描述: %s\n", response.Err_code_des)
fmt.Println("========================================")
//打印支付结果到网页
w.Header().Set("Access-Control-Allow-Origin", "*") //允许访问所有域,解决跨域问题
fmt.Fprintf(w, "支付返回数据如下\n")
fmt.Fprintf(w, response.ReponseXML)
}
和/micropay地址关联
在main.go文件里面
加入头文件
"wechatpaygolang/micropay"在
rout函数里面加入路由func rout(w http.ResponseWriter, r *http.Request) { r.ParseForm() path := r.URL.Path if path == "/helloworld" { fmt.Println("被扫支付") helloworld.HelloWorld(w, r) } else if path == "/micropay" { fmt.Println("被扫支付") micropay.Micropay(w, r) } }
这里我们就完成对url地址：/micropay和micropay.Micropay()函数的关联
测试
打开浏览器，访问地址:localhost/micropay?fee=1&authcode=AUTHCODE，得到如下运行结果，这里我的付款码不对，所以不会正确扣款
支付结果判断
reponse.Return_code为SUCCESS，response.Result_code为SUCCESS,表示支付成功
reponse.Return_code为SUCCESS，reponse.Result_code为FAIL,reponse.Err_code为USERPAYING 表示正在输入密码
更多reponse.Err_code以及对应的处理办法
| 名称 | 描述 | 原因 | 解决方案 |
|---|---|---|---|
| SYSTEMERROR | 接口返回错误 | 系统超时 | 请立即调用被扫订单结果查询API，查询当前订单状态，并根据订单的状态决定下一步的操作 |
| ORDERPAID | 订单已支付复 | 订单号重复 | 请确认该订单号是否重复支付，如果是新单，请使用新订单号提交 |
| NOAUTH | 商户无权限 | 商户没有开通被扫支付权限 | 请开通商户号权产品或商务申请 |
| AUTHCODEEXPIRE | 二维码已过期，请用户在微信上刷新后再试 | 用户的条码已经过期 | 请收银员提示用户，请用户在微信上刷新条码，然后请收银员重新扫码。 直接将错误展示给收银员 |
| NOTENOUGH | 余额不足 | 用户的零钱余额不足 | 请收银员提示用户更换当前支付的卡，然后请收银员重新扫码。建议：商户系统返回给收银台的提示为“用户余额不足.提示用户换卡支付” |
| NOTSUPORTCARD | 不支持卡类型 | 用户使用卡种不支持当前支付形式,请用户重新选择卡种 | 建议：商户系统返回给收银台的提示为“该卡不支持当前支付，提示用户换卡支付或绑新卡支付” |
| ORDERCLOSED | 订单已关闭 | 该订单已关 | 商户订单号异常，请重新下单支付 |
| ORDERREVERSED | 订单已撤销 | 当前订单已经被撤销 | 当前订单状态为“订单已撤销”，请提示用户重新支付 |
| BANKERROR | 银行系统异常 | 银行端超时 | 请立即调用被扫订单结果查询API，查询当前订单的不同状态，决定下一步的操作 |
| USERPAYING | 用户支付中，需要输入密码 | 该笔交易因为业务规则要求，需要用户输入支付密码 | 等待5秒，然后调用被扫订单结果查询API，查询当前订单的不同状态，决定下一步的操作 |
| AUTH_CODE_ERROR | 授权码参数错误 | 请求参数未按指引进行填写 | 每个二维码仅限使用一次，请刷新再试 |
| AUTH_CODE_INVALID | 授权码检验错误 | 收银员扫描的不是微信支付的条码 | 请扫描微信支付被扫条码/二维码 |
| XML_FORMAT_ERROR | XML格式错误 | XML格式错误 | 请检查XML参数格式是否正确 |
| REQUIRE_POST_METHOD | 请使用post方法 | 未使用post传递参数 | 请检查请求参数是否通过post方法提交 |
| SIGNERROR | 签名错误 | 参数签名结果不正确 | 请检查签名参数和方法是否都符合签名算法要求 |
| LACK_PARAMS | 缺少参数 | 缺少必要的请求参数 | 请检查参数是否齐全 |
| NOT_UTF8 | 编码格式错误 | 未使用指定编码格式 | 请使用UTF8编码格式 |
| BUYER_MISMATCH | 支付帐号错误 | 暂不支持同一笔订单更换支付方 | 请确认支付方是否相同 |
| APPID_NOT_EXIST | APPID不存在 | 参数中缺少APPID | 请检查APPID是否正确 |
| MCHID_NOT_EXIST | MCHID不存在 | 参数中缺少MCHID | 请检查MCHID是否正确 |
| OUT_TRADE_NO_USED | 商户订单号重复 | 同一笔交易不能多次提交 | 请核实商户订单号是否重复提交 |
| APPID_MCHID_NOT_MATCH | appid和mch_id不匹配 | appid和mch_id不匹配 | 请确认appid和mch_id是否匹配 |
刷卡支付常见错误
签名错误
第一步：检查本地签名程序是否正确
使用签名检查工具（http://mch.weixin.qq.com/wiki/tools/signverify/）,检查签名本地签名程序是否有错误
如何用签名检查工具生成的签名和本地程序生成的签名不一致，说明程序有错误，请先检查本地代码程序。
如果无误，表示程序没有问题，进行下一步API秘钥设置
第二步：API密钥设置
在使用签名检查工具检查没有错误的情况下， 可以确定是API密钥设置出错。
微信支付必须保证本地签名使用的key值和在商户平台设置的API密钥一致。
设置方法：
登陆商户平台（https://pay.weixin.qq.com/index.php/home/login） ，设置位置：账户设置-安全设置-API安全