微信小程序支付需后端C#调用统一下单接口生成paySign等参数，前端调wx.requestPayment；签名须用UTF-8编码、URL编码参数、小写MD5，证书为32位API密钥的.p12格式，回调验签需解析原始XML并剔除sign节点。
微信小程序支付不是在 C# 里“发起支付”，而是在后端生成 paySign
很多人卡在第一步：以为 C# 要调起微信的 JSAPI 支付界面。其实不是——wx.requestPayment 是小程序前端调用的，C# 后端只负责准备签名参数、调用微信统一下单接口（https://api.mch.weixin.qq.com/pay/unifiedorder），返回 package、timeStamp、nonceStr、signType 和最关键的 paySign。
常见错误现象：
• 小程序报错 requestPayment:fail invalid sign
• 微信返回 ERR_INVALID_PAYSIGN
• 本地调试正常，上线后签名失败（时间戳/nonceStr 未同步或重复）
- 必须用商户平台的 API 密钥（
key）参与签名，不是 AppSecret 或 APIv3 密钥 -
timeStamp必须是字符串格式的秒级时间戳（DateTimeOffset.Now.ToUnixTimeSeconds().ToString()），不能带毫秒 -
nonceStr每次请求必须唯一，建议用Guid.NewGuid().ToString("N")，别用随机数种子固定的值 - 签名原文拼接顺序严格按文档：
appId=wx…&nonceStr=…&package=…&signType=…&timeStamp=…&key=…，最后转成小写 MD5
C# 调用微信统一下单接口前，得先处理好证书和 HTTPS
微信商户平台要求所有 APIv2 接口（包括 unifiedorder）必须使用双向证书认证，不是简单加个 HttpClient 就能发请求。
常见错误现象：
• 报错 The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel.
• 返回 curl error: Peer certificate cannot be authenticated
• 本地能通，服务器上提示证书找不到或密码错误
- 证书必须是
.p12格式（不是.pem或.crt），且由微信商户平台下载的apiclient_cert.p12直接使用 - 加载证书时，密码是商户平台设置的「API 密钥」（注意：不是登录密码，也不是 APIv3 密钥），长度必须为 32 位，不足补空格或截断都导致失败
- 别用
ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12强制协议——.NET Core 2.1+ 默认已支持，加了反而可能干扰 - 推荐用
HttpClientHandler.ClientCertificates加载，不要用过时的WebRequest+ClientCertificates.Add
签名计算最容易出错的三个地方：编码、换行、大小写
微信签名不是简单拼字符串再 MD5——它对字符编码、空白、大小写极其敏感，尤其在 .NET 中默认 UTF-8 但没显式声明时容易踩坑。
常见错误现象：
• 本地测试通过，部署到 Linux 服务器失败（Encoding.Default 在 Windows/Linux 不同）
• 商品名含中文时签名不一致
• signType=HMAC-SHA256 时返回签名错误（实际该模式不用 MD5，但很多人仍套用老逻辑）
- 签名原文必须用
Encoding.UTF8编码后计算哈希，不能依赖Encoding.Default - 拼接参数前，每个 value 必须做 URL 编码（
WebUtility.UrlEncode），但注意：微信要求的是「不带空格的 UTF-8 编码」，所以传参前先.Replace("+", "%20") - MD5 结果必须转成小写 32 位十六进制字符串（
hash.ToLowerInvariant()），大写或带横线都会被拒 - 如果用
signType=HMAC-SHA256，密钥要用 APIv3 密钥（32 字节 base64），且签名算法完全不一样，别混用
回调通知验签必须解析原始 XML，不能直接读 Request.Form
微信支付成功后会 POST 一个 XML 到你的回调地址，很多人直接用 MVC 的 FormCollection 或 Request.Form["result_code"] 取值，结果验签永远失败。
常见错误现象：
• 回调返回 success，但业务没更新订单状态
• 验签失败日志里显示 sign is empty 或 sign verify failed
• 用 Postman 模拟 XML 请求能过，真实微信推送就失败
- 必须用
Request.Body读取原始字节流，再用Encoding.UTF8.GetString解码成 XML 字符串，不能走模型绑定或表单解析 - 验签前要先把
appid=…&bank_type=…&cash_fee=…&key=…），注意字段名全小写、无下划线 - 微信回调 IP 不固定，别在防火墙或 Nginx 层拦掉非白名单 IP，否则收不到通知
- 收到回调后必须立即返回
最麻烦的从来不是写代码，而是微信文档里没写的细节：比如 out_trade_no 最长 32 位但部分银行限制 28 位，比如沙箱环境的 appid 和正式环境不一致，比如证书密码输错三次会被临时锁定——这些都得实打实试出来。
