应选用gopay库而非自行实现或使用已归档/有兼容问题的SDK；v3接口需证书双向认证，严格按PEM格式、apiV3Key、无密钥等要求配置；JSAPI支付paySign须后端生成；回调须先解密再验签，并做幂等处理。
微信支付 SDK 选型：别自己造轮子，但得知道轮子怎么转
Go 生态里没有官方微信支付 SDK，gopay 是目前最成熟、更新活跃的第三方库，支持 JSAPI、APP、H5、Native、合单等主流模式。它不封装业务逻辑，只做协议层透传——这反而是优势：你不用猜它内部怎么拼签名、怎么验签，所有字段可控，出问题能快速定位到 Sign 或 VerifySign 这一级。
注意避开几个坑：wechatpay-go（腾讯官方早期版本）已归档且不维护；go-wxpay 签名逻辑有兼容性问题，尤其在 v3 接口时间戳和证书序列号处理上容易返回 401 unauthorized；直接用 net/http 手写请求看似“轻量”，但验签、证书加载、自动重试、敏感字段脱敏等都要自己补，上线后第一笔退款失败就很难收场。
v3 接口必须走证书双向认证，别用 v2 的思维套用
v3 接口强制要求使用平台证书验证响应签名，并用商户私钥对请求签名。不是简单配个 appid 和 mchid 就能跑通。常见错误是把 v2 的 API 密钥当 v3 的 APIv3 Key 用，结果所有请求都返回 {"code":"INVALID_REQUEST","message":"invalid request"}，实际是签名头 Authorization 构造失败。
实操要点：
立即学习“go语言免费学习笔记（深入）”；
- 从微信商户平台「API 安全」页下载的
apiclient_cert.p12必须转成 PEM 格式（用openssl pkcs12 -clcerts -nokeys -in apiclient_cert.p12 -out cert.pem），gopay只认 PEM -
apiV3Key是单独在「API 安全」页设置的 32 位字符串，不是商户平台登录密码，也不是 API 密钥 - 初始化客户端时，
certFile和keyFile必须指向解密后的私钥文件（apiclient_key.pem），且该文件不能带密码——gopay不支持带密码的 key - 每次请求的
nonce_str必须全局唯一，建议用uuid.NewString()，别用时间戳或自增 ID
统一下单后别硬编码跳转逻辑，JSAPI 需要后端动态注入 timestamp
JSAPI 支付的 paySign 必须由后端生成，前端不能自己拼。常见错误是把 time.Unix().Unix() 直接塞进前端，导致签名过期或时间偏差被拒（微信要求时间戳误差不超过 5 分钟）。
正确做法是统一下单成功后，把以下字段一并返回给前端：
-
appId（固定值，从配置读） -
timeStamp（服务端当前 Unix 时间戳，单位秒，time.Now().Unix()） -
nonceStr（新生成，不能复用下单时的） -
package（固定为prepay_id=wx123...） -
signType（固定RSA） -
paySign（调用wechat.GetPaySign()生成）
注意：paySign 签名原文是按字段名 ASCII 升序拼接的键值对（不含空格和换行），gopay 的 GetPaySign 函数已封装好，但务必确认传入的 map[string]string 里 key 全是小写且无多余空格。
回调验签是生死线，别信 raw body 就安全
微信回调的 body 是 AES-256-GCM 加密的，必须先解密再验签。很多同学直接读 r.Body 拿原始 JSON，结果永远验签失败——因为那根本不是真实数据。
关键步骤：
- 先用
io.ReadAll(r.Body)获取原始加密 payload - 调用
wechat.DecryptNotify()，传入apiV3Key和原始 payload，得到明文 map - 从明文 map 中取
data字段，再用wechat.VerifySign()对data的 JSON 字符串验签（不是对整个回调 body） - 验签通过后，检查
event_type是TRANSACTION.SUCCESS还是REFUND.SUCCESS，再查数据库更新状态
最容易忽略的是：微信回调可能重复推送，必须做幂等判断（比如用 out_trade_no + transaction_id 做联合唯一索引），否则用户一笔支付收到三次发货通知。
