别再问用 Go 语言如何对接微信支付了:看看这个包
作为开发人员,微信生态我们不能无视,微信提供的开放能力,我们应该有所了解。微信支付作为重要的一部分,平时工作中可能难免会遇到。Go 作为一门新语言,微信支付没有提供 Go 的 SDK。你可以选择自己实现,也可以找第三方实现好的。对于第三方,即使不自己实现,看看别人怎么实现的,对自己也会有启发。今天就为大家推荐一个微信支付 Go SDK,收藏以备不时之需吧。
项目地址:https://github.com/pyihe/wechat-sdk。
一、功能列表
已经实现的功能如下。
Mini Program(小程序)
Name | Explain | comment |
---|---|---|
GetUserPhoneForMini | 小程序获取电话号码 | 客户端调用微信接口获取加密信息时不能在回调中再次调用登陆接口, 否则会让session_key失效 |
GetSessionKeyAndOpenId | 通过小程序授权code获取session_key和用户openid | |
GetAccessTokenForMini | 小程序获取AccessToken | |
GetUserInfoForMini | 小程序获取用户基本信息 |
Official Accounts(公众号)
Name | Explain | comment |
---|---|---|
GetAppBaseAccessToken | 公众号开发获取基础接口调用Access_Token | 用于调用其他接口 |
GetAppOauthAccessToken | 公众号开发通过code获取网页授权Access_Token | 此Access_Token用于拉取用户信息, code只能用一次 |
RefreshOauthToken | 公众号开发刷新网页授权Access_Token | |
GetAppUserInfo | 公众号开发拉取用户信息 | 返回结果参考微信文档[1] |
CheckOauthToken | 公众号开发校验网页授权Access_Token是否有效 |
WeChat Pay(微信支付)
Name | Explain | comment |
---|---|---|
CloseOrder | 关闭订单 | |
DownloadBill | 下载对账单 | |
DownloadComment | 拉取订单评论 | |
DownloadFundFlow | 下载资金账单 | |
GetPublicKey | 获取RSA加密公钥 | |
RefundOrder | 申请退款 | |
RefundNotify | 解析微信退款回调内容, 主要是对req_info解密 | |
RefundQuery | 退款查询 | |
Report | 向微信发送接口调用结果的报告, 包括接口调用时间 | |
ReverseOrder | 撤销订单 | |
Transfers | 企业付款到用户零钱 | |
TransfersQuery | 查询企业付款到用户零钱的结果 | |
TransferBank | 企业付款到银行卡 | 未测试 |
TransferBankQuery | 查询企业付款到银行卡的结果 | 未测试 |
UnifiedMicro | 扫码下单 | 如果需要传detail参数, 参数格式参照单品优惠活动detail字段列表说明[2] |
UnifiedOrder | 统一下单: H5/APP/MWEB/NATIVE | 返回给前端的唤起支付参数中, package = prepay_id=xxxxxxx |
UnifiedQuery | 下单结果查询 |
ProfitSharing(商户分账)
Name | Explain | comment |
---|---|---|
ProfitSharing | 申请分账(单次或多次) | multiTag标志是否是多次分账 |
QueryProfitSharing | 查询分账请求的结果 | 非分账的结果,而是分账申请的结果 |
AddProfitSharingReceiver | 添加分账接收方 | |
RemoveProfitSharingReceiver | 删除分账接受方 | |
FinishProfitSharing | 完结分账 | 如果订单不需要(再)分账, 且剩余待分账金额不为0时, 调用本接口将剩余金额冻结给特约商户 |
ReturnProfitSharing | 分账回退 | 对已分账的订单进行退款时,先调用本接口将金额从分账接收方回退给商户(非异步, 同步回传回退结果) |
QueryProfitSharingReturn | 回退结果查询 | 用于核实回退结果 |
ProfitSharingNotify | 分账动帐通知 | 分账或分账回退成功后, 微信会将结果发送给商户, 通知结果包含加密信息, 此处解密密钥为ApiV3密钥。接口返回结果中忽略层级关系,对于需要的字段直接使用Get方法获取值。通知url在商户平台配置,详情参加分账动帐通知[3] |
RedPack(现金红包)
Name | Explain | comment |
---|---|---|
SendRedPack | 发放现金红包 | |
SendGroupRedPack | 发放裂变红包 | |
GetRedPackRecords | 查询红包记录 |
注意:NewPayer() 必须传入所有需要使用的微信参数,使用过程中所有请求接口都不需要加入appid/mch_id/ApiKey/secret/sign/ApiV3Key参数
二、使用示例
package main
import (
"fmt"
dev "github.com/pyihe/wechat-sdk"
)
func main() {
var appId, mchId, apiKey, apiSecret string
client := dev.NewPayer(dev.WithAppId(appId), dev.WithMchId(mchId), dev.WithApiKey(apiKey), dev.WithSecret(apiSecret))
// unified order(统一下单)
param := dev.NewParam()
param.Add("nonce_str", "yourNonceStr")
param.Add("body", "yourBody")
param.Add("out_trade_no", "yourOutTradeNo")
param.Add("total_fee", 1)
param.Add("spbill_create_ip", "yourIp")
param.Add("notify_url", "yourUrl")
param.Add("trade_type", "JSAPI")
result, err := client.UnifiedOrder(param)
if err != nil {
handleErr(err)
}
appId, _ = result.GetString("apppid")
prepayId, _ := result.GetString("prepay_id")
param = dev.NewParam()
param.Add("appId", appId)
param.Add("timeStamp", time.Now().Unix())
param.Add("nonceStr", "nonceStr")
param.Add("package", "prepay_id="+prepayId)
param.Add("signType", "MD5")
//use to evoke wechat pay
sign := param.Sign("MD5")
// download bill
param = dev.NewParam()
param.Add("nonce_str", "yourNonceStr")
param.Add("bill_date", "yourDate")
param.Add("bill_type", "ALL")
param.Add("tar_type", "GZIP")
err = client.DownloadBill(param, "./bill")
if err != nil {
handleErr(err)
}
// get phone for mini program user
result, err = client.GetUserPhoneForMini("code", "encryptedData", "iv")
if err != nil {
handleErr(err)
}
var phone string
if countryCode := result.Get("countryCode"); countryCode != nil && countryCode.(string) == "86" {
purePhone := result.Get("purePhoneNumber")
phone = purePhone.(string)
} else {
phoneNumber := result.Get("phoneNumber")
phone = phoneNumber.(string)
}
fmt.Printf("user phone is %s\n", phone)
}
退款通知的回调。
package main
import (
"fmt"
"net/http"
dev "github.com/pyihe/wechat-sdk"
)
func main() {
var appId, mchId, apiKey, apiSecret string
client := dev.NewPayer(dev.WithAppId(appId), dev.WithMchId(mchId), dev.WithApiKey(apiKey), dev.WithSecret(apiSecret))
// handle refund notify
http.HandleFunc("/refund_notify", func(writer http.ResponseWriter, request *http.Request) {
defer request.Body.Close()
result, err := client.RefundNotify(request.Body)
if err != nil {
handleErr(err)
}
fmt.Printf("RefundNotify Result = %v\n", result.Data())
})
http.ListenAndServe(":8810", nil)
}
参考资料
微信文档: https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html
[2]单品优惠活动detail字段列表说明: https://pay.weixin.qq.com/wiki/doc/api/danpin.php?chapter=9_102&index=2
[3]分账动帐通知: https://pay.weixin.qq.com/wiki/doc/api/allocation.php?chapter=27_9&index=9
推荐阅读
站长 polarisxu
自己的原创文章
不限于 Go 技术
职场和创业经验
Go语言中文网
每天为你
分享 Go 知识
Go爱好者值得关注
评论