fork by https://github.com/objcoding/wxpay
wxpay 提供了以下的方法:
方法名 | 说明 |
---|---|
MicroPay | 刷卡支付 |
UnifiedOrder | 统一下单 |
OrderQuery | 查询订单 |
Reverse | 撤销订单 |
CloseOrder | 关闭订单 |
Refund | 申请退款 |
RefundQuery | 查询退款 |
DownloadBill | 下载对账单 |
Report | 交易保障 |
ShortUrl | 转换短链接 |
AuthCodeToOpenid | 授权码查询openid |
TransfersToUserDibByOpenid | 付款到零钱 |
TransfersGetTransferInfo | 查询付款 |
- 参数为
Params
类型,返回类型也是Params
,Params
是一个 map[string]string 类型。 - 方法内部会将参数会转换成含有
appid
、mch_id
、nonce_str
、sign_type
和sign
的XML; - 默认使用MD5进行签名;
- 通过HTTPS请求得到返回数据后会对其做必要的处理(例如验证签名,签名错误则抛出异常)。
- 对于DownloadBill,无论是否成功都返回Map,且都含有
return_code
和return_msg
。若成功,其中return_code
为SUCCESS
,另外data
对应对账单数据。
$ go get github.com/tyz-coder/wxpay
// go.mod
require github.com/tyz-coder/wxpay v1.0.7
// 创建支付账户
account1 := wxpay.NewAccount("appid", "mchid", "apiKey", false)
account2 := wxpay.NewAccount("appid", "mchid", "apiKey", false)
// 新建微信支付客户端
client := wxpay.NewClient(account1)
// 设置证书
account.SetCertData("证书地址")
// 设置支付账户
client.setAccount(account2)
// 设置http请求超时时间
client.SetHttpConnectTimeoutMs(2000)
// 设置http读取信息流超时时间
client.SetHttpReadTimeoutMs(1000)
// 更改签名类型
client.SetSignType(HMACSHA256)
// 统一下单
params := make(wxpay.Params)
params.SetString("body", "test").
SetString("out_trade_no", "436577857").
SetInt64("total_fee", 1).
SetString("spbill_create_ip", "127.0.0.1").
SetString("notify_url", "http://notify.objcoding.com/notify").
SetString("trade_type", "APP")
p, _ := client.UnifiedOrder(params)
// 订单查询
params := make(wxpay.Params)
params.SetString("out_trade_no", "3568785")
p, _ := client.OrderQuery(params)
// 退款
params := make(wxpay.Params)
params.SetString("out_trade_no", "3568785").
SetString("out_refund_no", "19374568").
SetInt64("total_fee", 1).
SetInt64("refund_fee", 1)
p, _ := client.Refund(params)
// 退款查询
params := make(wxpay.Params)
params.SetString("out_refund_no", "3568785")
p, _ := client.RefundQuery(params)
// 向用户零钱付款
payAccount := NewAccount("xxxxx", "xxx", "xxxxx", false)
// 设置支付证书
payAccount.SetCertData("")
// 加载支付终端
client := NewClient(payAccount)
// 加载请求参数
params := make(Params)
params.SetString("mch_appid", payAccount.appID) // 申请商户号的appid或商户号绑定的appid
params.SetString("mchid", payAccount.mchID) // 微信支付分配的商户号
params.SetString("device_info", "") // 微信支付分配的终端设备号(非必填字段)
params.SetString("nonce_str", NonceStr()) // 随机字符串,不长于32位
params.SetString("partner_trade_no", "xxx") // 商户订单号 商户订单号,需保持唯一性 (只能是字母或者数字,不能包含有其它字符)
params.SetString("openid", "xxx") // 商户appid下,某用户的openid
params.SetString("check_name", "NO_CHECK") // 校验用户姓名选项(默认校验真实姓名) NO_CHECK:不校验真实姓名 FORCE_CHECK:强校验真实姓名
params.SetString("re_user_name", "xxxx") // 收款用户姓名
params.SetInt64("amount", 1) // 付款金额,单位为分
params.SetString("desc", "测试付款") // 付款备注(小于100字符)
params.SetString("spbill_create_ip", "127.0.0.1") // Ip地址
params.SetString("sign", client.Sign(params)) // 签名 - 签名算法:https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=4_3
p, err := client.TransfersToUserDibByOpenid(params)
fmt.Println(p, err)
// 查询转账记录
payAccount := NewAccount("xxxxx", "xxx", "xxxxx", false)
// 设置支付证书
payAccount.SetCertData("")
// 加载支付终端
client := NewClient(payAccount)
// 加载请求参数
params := make(Params)
params.SetString("appid", payAccount.appID) // 申请商户号的appid或商户号绑定的appid
params.SetString("mch_id", payAccount.mchID) // 微信支付分配的商户号
params.SetString("nonce_str", NonceStr()) // 随机字符串,不长于32位
params.SetString("partner_trade_no", "xxx") // 商户订单号 商户订单号,需保持唯一性 (只能是字母或者数字,不能包含有其它字符)
params.SetString("sign", client.Sign(params)) // 签名 - 签名算法:https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=4_3
p, err := client.TransfersGetTransferInfo(params)
fmt.Println(p, err)
// 签名
signStr := client.Sign(params)
// 校验签名
b := client.ValidSign(params)
// xml解析
params := wxpay.XmlToMap(xmlStr)
// map封装xml请求参数
b := wxpay.MapToXml(params)
// 支付或退款返回成功信息
return wxpay.Notifies{}.OK()
// 支付或退款返回失败信息
return wxpay.Notifies{}.NotOK("支付失败或退款失败了")
MIT license