《开源精选》是我们分享Github、Gitee等开源社区中优质项目的栏目，包括技术、学习、实用与各种有趣的内容。本期推荐的是一个使用Go语言的相关集合支付库-支持微信、支付宝、PayPal、QQ 支付。

一、安装

go get -u github.com/go-pay/gopay

查看 GoPay 版本

import (    "github.com/go-pay/gopay"    "github.com/go-pay/gopay/pkg/xlog")func main() {    xlog.Info("GoPay Version: ", gopay.Version)}

支付宝支付

1、初始化支付宝客户端并做配置

具体API使用介绍，请参考 gopay/alipay/client_test.go

import (    "github.com/go-pay/gopay/alipay"    "github.com/go-pay/gopay/pkg/xlog")// 初始化支付宝客户端//    appId：应用ID//    privateKey：应用私钥，支持PKCS1和PKCS8//    isProd：是否是正式环境client, err := alipay.NewClient("2016091200494382", privateKey, false)if err != nil {    xlog.Error(err)    return}// 打开Debug开关，输出日志，默认关闭client.DebugSwitch = gopay.DebugOn// 设置支付宝请求 公共参数//    注意：具体设置哪些参数，根据不同的方法而不同，此处列举出所有设置参数client.SetLocation(alipay.LocationShanghai).    // 设置时区，不设置或出错均为默认服务器时间    SetCharset(alipay.UTF8).                    // 设置字符编码，不设置默认 utf-8    SetSignType(alipay.RSA2).                   // 设置签名类型，不设置默认 RSA2    SetReturnUrl("https://www.fmm.ink").        // 设置返回URL    SetNotifyUrl("https://www.fmm.ink").        // 设置异步通知URL    SetAppAuthToken()                           // 设置第三方应用授权// 自动同步验签（只支持证书模式）// 传入 alipayCertPublicKey_RSA2.crt 内容client.AutoVerifySign([]byte("alipayCertPublicKey_RSA2 bytes"))// 公钥证书模式，需要传入证书，以下两种方式二选一// 证书路径err := client.SetCertSnByPath("appCertPublicKey.crt", "alipayRootCert.crt", "alipayCertPublicKey_RSA2.crt")// 证书内容err := client.SetCertSnByContent("appCertPublicKey bytes", "alipayRootCert bytes", "alipayCertPublicKey_RSA2 bytes")

2、API 方法调用及入参(统一收单交易支付接口 示例)

import (    "github.com/go-pay/gopay")// 初始化 BodyMapbm := make(gopay.BodyMap)bm.Set("subject", "条码支付").    Set("scene", "bar_code").    Set("auth_code", "286248566432274952").    Set("out_trade_no", "GZ201909081743431443").    Set("total_amount", "0.01").    Set("timeout_express", "2m")aliRsp, err := client.TradePay(bm)if err != nil {    xlog.Error("err:", err)    return}

3、同步返回参数验签Sign、异步通知参数解析和验签Sign、异步通知返回

异步通知请求参数需要先解析，解析出来的结构体或BodyMap再验签（此处需要注意，http.Request.Body 只能解析一次，如果需要解析前调试，请处理好Body复用问题）

• 同步返回验签，手动验签（如已开启自动验签，则无需手动验签操作）

import (    "github.com/go-pay/gopay/alipay")aliRsp, err := client.TradePay(bm)if err != nil {    xlog.Error("err:", err)    return}// 公钥模式验签//    注意：APP支付，手机网站支付，电脑网站支付 不支持同步返回验签//    aliPayPublicKey：支付宝平台获取的支付宝公钥//    signData：待验签参数，aliRsp.SignData//    sign：待验签sign，aliRsp.Signok, err := alipay.VerifySyncSign(aliPayPublicKey, aliRsp.SignData, aliRsp.Sign)// 公钥证书模式验签//    aliPayPublicKeyCert：支付宝公钥证书存放路径 alipayCertPublicKey_RSA2.crt 或文件内容[]byte//    signData：待验签参数，aliRsp.SignData//    sign：待验签sign，aliRsp.Signok, err := alipay.VerifySyncSignWithCert(aliPayPublicKeyCert, aliRsp.SignData, aliRsp.Sign)

• 异步通知验签

import (    "github.com/go-pay/gopay/alipay")// 解析异步通知的参数//    req：*http.RequestnotifyReq, err = alipay.ParseNotifyToBodyMap(c.Request)     // c.Request 是 gin 框架的写法if err != nil {    xlog.Error(err)    return} 或//    value：url.ValuesnotifyReq, err = alipay.ParseNotifyByURLValues()if err != nil {    xlog.Error(err)    return}// 支付宝异步通知验签（公钥模式）ok, err = alipay.VerifySign(aliPayPublicKey, notifyReq)// 支付宝异步通知验签（公钥证书模式）ok, err = alipay.VerifySignWithCert("alipayCertPublicKey_RSA2.crt content", notifyReq)// ====异步通知，返回支付宝平台的信息====//    文档：https://opendocs.alipay.com/open/203/105286//    程序执行完后必须打印输出“success”（不包含引号）。如果商户反馈给支付宝的字符不是success这7个字符，支付宝服务器会不断重发通知，直到超过24小时22分钟。一般情况下，25小时以内完成8次通知（通知的间隔频率一般是：4m,10m,10m,1h,2h,6h,15h）// 此写法是 gin 框架返回支付宝的写法c.String(http.StatusOK, "%s", "success")// 此写法是 echo 框架返回支付宝的写法return c.String(http.StatusOK, "success")

微信支付

1、初始化微信v3客户端并做配置

import (    "github.com/go-pay/gopay/pkg/xlog"    "github.com/go-pay/gopay/wechat/v3")// NewClientV3 初始化微信客户端 v3//	mchid：商户ID 或者服务商模式的 sp_mchid// 	serialNo：商户证书的证书序列号//	apiV3Key：apiV3Key，商户平台获取//	privateKey：私钥 apiclient_key.pem 读取后的内容client, err = wechat.NewClientV3(MchId, SerialNo, APIv3Key, PrivateKey)if err != nil {    xlog.Error(err)    return}// 启用自动同步返回验签，并定时更新微信平台API证书err = client.AutoVerifySign()if err != nil {    xlog.Error(err)    return}// 打开Debug开关，输出日志，默认是关闭的client.DebugSwitch = gopay.DebugOn

2、API 方法调用及入参（JSAPI下单 示例）

import (    "github.com/go-pay/gopay")expire := time.Now().Add(10 * time.Minute).Format(time.RFC3339)// 初始化 BodyMapbm := make(gopay.BodyMap)bm.Set("sp_appid", "sp_appid").    Set("sp_mchid", "sp_mchid").    Set("sub_mchid", "sub_mchid").    Set("description", "测试Jsapi支付商品").    Set("out_trade_no", tradeNo).    Set("time_expire", expire).    Set("notify_url", "https://www.fmm.ink").    SetBodyMap("amount", func(bm gopay.BodyMap) {        bm.Set("total", 1).            Set("currency", "CNY")    }).    SetBodyMap("payer", func(bm gopay.BodyMap) {        bm.Set("sp_openid", "asdas")    })wxRsp, err := client.V3TransactionJsapi(bm)if err != nil {    xlog.Error(err)    return}

3、下单后，获取微信小程序支付、APP支付、JSAPI支付所需要的 pay sign

// 小程序applet, err := client.PaySignOfApplet("appid", "prepayid")// appapp, err := client.PaySignOfApp("appid", "prepayid")// jsapijsapi, err := client.PaySignOfJSAPI("appid", "prepayid")

4、同步返回参数验签Sign、异步通知参数解析和验签Sign、异步通知返回

异步通知请求参数需要先解析，解析出来的结构体或BodyMap再验签（此处需要注意，http.Request.Body 只能解析一次，如果需要解析前调试，请处理好Body复用问题）

• 同步返回验签，手动验签（如已开启自动验签，则无需手动验签操作）

import (    "github.com/go-pay/gopay/wechat/v3"    "github.com/go-pay/gopay/pkg/xlog")wxRsp, err := client.V3TransactionJsapi(bm)if err != nil {    xlog.Error(err)    return}// wxPublicKey 通过 client.WxPublicKey() 获取err = wechat.V3VerifySignByPK(wxRsp.SignInfo.HeaderTimestamp, wxRsp.SignInfo.HeaderNonce, wxRsp.SignInfo.SignBody, wxRsp.SignInfo.HeaderSignature, wxPublicKey)if err != nil {    xlog.Error(err)    return}

• 异步通知验签 及 敏感参数解密

import (    "github.com/go-pay/gopay/wechat/v3"    "github.com/go-pay/gopay/pkg/xlog")notifyReq, err := wechat.V3ParseNotify()if err != nil {    xlog.Error(err)    return}// wxPublicKey 通过 client.WxPublicKey() 获取err = notifyReq.VerifySignByPK(wxPublicKey)if err != nil {    xlog.Error(err)    return}// ========异步通知敏感信息解密========// 普通支付通知解密result, err := notifyReq.DecryptCipherText(apiV3Key)// 合单支付通知解密result, err := notifyReq.DecryptCombineCipherText(apiV3Key)// 退款通知解密result, err := notifyReq.DecryptRefundCipherText(apiV3Key)// ========异步通知应答========// 退款通知http应答码为200且返回状态码为SUCCESS才会当做商户接收成功，否则会重试。// 注意：重试过多会导致微信支付端积压过多通知而堵塞，影响其他正常通知。// 此写法是 gin 框架返回微信的写法c.JSON(http.StatusOK, &wechat.V3NotifyRsp{Code: gopay.SUCCESS, Message: "成功"})// 此写法是 echo 框架返回微信的写法return c.JSON(http.StatusOK, &wechat.V3NotifyRsp{Code: gopay.SUCCESS, Message: "成功"})

更多内容：https://github.com/go-pay/gopay