Categorygithub.com/jdomzhang/wxpay
repositorypackage
1.1.7
Repository: https://github.com/jdomzhang/wxpay.git
Documentation: pkg.go.dev

# README

wxpay

wxpay 提供了以下的方法:

方法名说明
MicroPay刷卡支付
UnifiedOrder统一下单
OrderQuery查询订单
Reverse撤销订单
CloseOrder关闭订单
Refund申请退款
RefundQuery查询退款
DownloadBill下载对账单
Report交易保障
ShortUrl转换短链接
AuthCodeToOpenid授权码查询 openid
  • 参数为Params类型,返回类型也是ParamsParams 是一个 map[string]string 类型。
  • 方法内部会将参数会转换成含有appidmch_idnonce_strsign_typesign的 XML;
  • 默认使用 MD5 进行签名;
  • 通过 HTTPS 请求得到返回数据后会对其做必要的处理(例如验证签名,签名错误则抛出异常)。
  • 对于 DownloadBill,无论是否成功都返回 Map,且都含有return_codereturn_msg。若成功,其中return_codeSUCCESS,另外data对应对账单数据。

安装

$ go get github.com/jdomzhang/wxpay

go modules

// go.mod
require github.com/jdomzhang/wxpay v1.1.1

示例

// 小程序统一下单
mp := wxpay.NewMP("appid", "mchid", "apiKey")
ouput, _ := mp.Prepay(&wxpay.InputMP{
	OpenID: "xxx",
	Body: "test",
	OutTradeNo: "1234",
	TotalFee: 1,
	IP: "127.0.0.1",
	NotifyURL: "https://example.com/notify",
})


// 创建支付账户
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.jdomzhang.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)

// 签名
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("支付失败或退款失败了")

License

MIT license