GoPay项目微信支付V2接口开发指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00991/article/details/148507878

GoPay项目微信支付V2接口开发指南

gopay go-pay/gopay 是一个用于集成多种支付方式的 Go 语言包。适合在 Go 语言开发的应用程序中实现支付功能。特点是提供了简洁易用的 API、丰富的支付方式和良好的兼容性。项目地址: https://gitcode.com/gh_mirrors/go/gopay

前言

在移动支付领域，微信支付是开发者常用的支付方式之一。GoPay项目提供了简洁易用的微信支付V2接口封装，帮助Go开发者快速集成微信支付功能。本文将详细介绍如何使用GoPay项目进行微信支付V2接口的开发。

一、微信支付V2接口概述

微信支付V2接口是微信支付提供的传统接口版本，虽然官方推荐使用V3接口，但在某些场景下V2接口仍有其使用价值。GoPay项目对微信支付V2接口进行了完整封装，开发者可以轻松调用各种支付功能。

二、初始化微信V2客户端

1. 基本初始化

首先需要创建微信支付客户端实例：

import "github.com/go-pay/gopay/wechat"

// 参数说明：
// appId: 微信应用ID
// mchId: 微信商户号
// apiKey: 微信商户API密钥
// isProd: 是否生产环境(true:生产环境 false:沙箱环境)
client := wechat.NewClient("wxdaa2ab9ef87b5497", mchId, apiKey, false)

2. 高级配置

// 开启调试模式(输出请求日志)
client.DebugSwitch = gopay.DebugOn

// 设置HTTP请求体大小限制(默认10MB)
client.SetBodySize(20 * 1024 * 1024) // 设置为20MB

// 设置国家/地区(默认中国国内)
client.SetCountry(wechat.China)

3. 证书配置

微信支付部分接口需要证书验证，支持两种证书格式：

PEM格式证书配置：

// 通过文件路径添加证书
err := client.AddCertPemFilePath("cert/apiclient_cert.pem", "cert/apiclient_key.pem")

// 或通过文件内容添加证书
certContent, _ := os.ReadFile("cert/apiclient_cert.pem")
keyContent, _ := os.ReadFile("cert/apiclient_key.pem")
err := client.AddCertPemFileContent(certContent, keyContent)

PKCS12格式证书配置：

// 通过文件路径添加证书
err := client.AddCertPkcs12FilePath("cert/apiclient_cert.p12")

// 或通过文件内容添加证书
pkcs12Content, _ := os.ReadFile("cert/apiclient_cert.p12")
err := client.AddCertPkcs12FileContent(pkcs12Content)

三、支付接口调用

1. 构建请求参数

使用gopay.BodyMap构建请求参数：

bm := make(gopay.BodyMap)
bm.Set("nonce_str", util.RandomString(32)).
    Set("body", "测试支付").
    Set("out_trade_no", "ORDER123456").
    Set("total_fee", 1).  // 单位:分
    Set("spbill_create_ip", "127.0.0.1").
    Set("notify_url", "https://yourdomain.com/notify").
    Set("trade_type", wechat.TradeType_H5).
    Set("device_info", "WEB").
    Set("sign_type", wechat.SignType_MD5)

2. 常用支付接口

统一下单接口：

wxRsp, err := client.UnifiedOrder(bm)
if err != nil {
    // 处理错误
}
fmt.Printf("返回结果: %+v\n", wxRsp)

查询订单接口：

queryBm := make(gopay.BodyMap)
queryBm.Set("out_trade_no", "ORDER123456")
wxRsp, err := client.QueryOrder(queryBm)

关闭订单接口：

closeBm := make(gopay.BodyMap)
closeBm.Set("out_trade_no", "ORDER123456")
wxRsp, err := client.CloseOrder(closeBm)

申请退款接口：

refundBm := make(gopay.BodyMap)
refundBm.Set("out_trade_no", "ORDER123456").
    Set("out_refund_no", "REFUND123456").
    Set("total_fee", 100).
    Set("refund_fee", 100)
wxRsp, err := client.Refund(refundBm)

四、支付签名处理

1. 小程序支付签名

timeStamp := strconv.FormatInt(time.Now().Unix(), 10)
packages := "prepay_id=" + wxRsp.PrepayId
paySign := wechat.GetMiniPaySign(appId, wxRsp.NonceStr, packages, wechat.SignType_MD5, timeStamp, apiKey)

2. APP支付签名

timeStamp := strconv.FormatInt(time.Now().Unix(), 10)
paySign := wechat.GetAppPaySign(appId, mchId, wxRsp.NonceStr, wxRsp.PrepayId, wechat.SignType_MD5, timeStamp, apiKey)

3. H5支付签名

timeStamp := strconv.FormatInt(time.Now().Unix(), 10)
packages := "prepay_id=" + wxRsp.PrepayId
paySign := wechat.GetH5PaySign(appId, wxRsp.NonceStr, packages, wechat.SignType_MD5, timeStamp, apiKey)

五、异步通知处理

1. 解析通知参数

// 解析支付通知
notifyReq, err := wechat.ParseNotifyToBodyMap(request)
if err != nil {
    // 处理错误
}

// 验证签名
ok, err := wechat.VerifySign(apiKey, wechat.SignType_MD5, notifyReq)
if !ok {
    // 签名验证失败
}

2. 退款通知处理

// 解析退款通知
notifyReq, err := wechat.ParseRefundNotify(request)

// 解密退款通知中的加密数据
refundNotify, err := wechat.DecryptRefundNotifyReqInfo(notifyReq.ReqInfo, apiKey)

3. 响应微信服务器

rsp := new(wechat.NotifyResponse)
rsp.ReturnCode = gopay.SUCCESS
rsp.ReturnMsg = gopay.OK

// 返回XML响应
c.String(http.StatusOK, rsp.ToXmlString())

六、附录：完整API列表

GoPay项目支持的微信支付V2接口包括但不限于：

基础支付接口
- 统一下单(UnifiedOrder)
- 扫码支付(Micropay)
- 订单查询(QueryOrder)
- 关闭订单(CloseOrder)
- 撤销订单(Reverse)
退款相关接口
- 申请退款(Refund)
- 退款查询(QueryRefund)
账单相关接口
- 下载对账单(DownloadBill)
- 下载资金账单(DownloadFundFlow)
其他功能接口
- 企业付款(Transfer)
- 企业付款查询(GetTransferInfo)
- 分账相关接口(ProfitSharing系列)
- 现金红包接口(SendCashRed等)