go语言不提供微信支付能力，需调用其http接口并严格处理签名、证书、加密及回调验签；推荐使用gopay或wechatpay-go等成熟库，避免手写导致的各类错误。
Go 语言本身不提供微信支付能力，所谓“对接”本质是调用微信支付的 HTTP 接口（v2 或 v3），并严格处理签名、证书、加密、回调验签等环节。直接用 net/http 手写容易出错，推荐使用经过生产验证的开源库，比如 gopay（支持 v2/v3）或 wechatpay-go（官方 v3 SDK）。自己造轮子在签名逻辑、证书加载、敏感字段加解密、异步通知验签上极易翻车。
为什么不用自己封装微信支付 HTTP 请求
微信支付 v2 接口依赖 MD5/SHA256 签名，参数顺序敏感、空值处理特殊、XML 封装固定；v3 接口强制 HTTPS、需双向证书、请求头含 Authorization（含时间戳、随机串、签名 Base64）、响应体 AES-GCM 解密。这些不是简单拼 URL 和发 POST 就能搞定的。
- 手写签名：漏掉
sign_type字段或排序时忽略空值 →INVALID_SIGNATURE - 证书加载失败：路径错误、权限不足、未用
crypto/tls正确加载 → TLS 握手失败，报x509: certificate signed by unknown authority - 回调验签：没校验
Wechatpay-Timestamp和Wechatpay-Nonce，或没用平台证书解密响应体 → 被伪造通知盗单
用 gopay 快速发起 JSAPI 支付（v2 版本）
gopay 封装了 v2 的统一下单、查询、退款、回调验签等核心流程，配置清晰，文档示例可直接跑通。注意它默认走 v2，若要用 v3 需切换分支或换库。
关键步骤：
- 安装：
go get github.com/iGoogle-ink/gopay - 初始化客户端：
client := &gopay.Client{MchID: "1900000109", AppID: "wxd678efh567hg6787", Key: "your_mch_key"}（Key是商户平台 API 密钥，非 APIv3 密钥） - 构造
alipay.BizParam类似结构的 map，必填body、out_trade_no、total_fee、spbill_create_ip、notify_url、trade_type（填"JSAPI"）和openid - 调用
client.UnifiedOrder(reqMap)，返回 XML 响应解析后取package、nonce_str、timestamp、paySign给前端调起wx.requestPayment
v3 接口必须用平台证书解密回调通知
微信 v3 回调通知的响应体是 AES-GCM 加密的 JSON，不能直接 json.Unmarshal。必须先用平台证书私钥（即你在商户平台下载的 apiclient_key.pem）解密，再解析 JSON。官方 wechanpay-go 提供了 DecryptNotify 方法，gopay v2 分支不支持此流程。
- 证书路径必须可读，且私钥不能带密码（微信导出的是无密码 PEM）
- 解密前需从请求头提取
Wechatpay-Serial（用于匹配证书）、Wechatpay-Timestamp、Wechatpay-Nonce、Wechatpay-Signature，用于验签 - 验签失败或解密失败，必须返回 HTTP 200 +
{"code":"FAIL","message":"failed"}，否则微信会重复推送 - 切勿在解密前记录原始 body —— 它是密文，日志里存了等于泄露用户交易数据
v3 的难点不在调用，而在证书生命周期管理（平台证书 24 小时轮换）、解密上下文复用、以及验签与解密的原子性。很多团队卡在“通知收到了但解不出来”，其实只是 apiclient_key.pem 没正确加载进 crypto/tls 的 Certificates 字段，或者混淆了商户 APIv3 密钥（用于请求签名）和平台证书私钥（用于解密通知）。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
