微信小程序支付开发全攻略，从零到上线的关键要点

说实话，我见过太多开发者在微信小程序支付这块栽跟头。不是代码写不出来，而是流程没搞明白，上线前被驳回，急得直跺脚。今天这篇东西，不跟你扯虚的，就把从零到上线那点关键事掰开揉碎了讲清楚。

很多人一上来就急着写代码，结果连商户号都没申请下来，白忙活一场。微信小程序支付，前提是你得有个企业资质的小程序，个人主体就别想了，微信根本不给你开支付接口。先登录微信支付商户平台，提交营业执照、法人身份证、银行账户这些材料，注意对公账户的户名必须和营业执照完全一致，一个字都不能差。审核一般一到三个工作日，但经常有人因为照片模糊或者信息填错被驳回，白白拖了一周。这里有个小窍门，如果你已经有认证过的小程序，可以在申请商户号时直接关联，省去重复审核的麻烦。

拿到商户号之后，别急着写代码，先把API密钥和证书搞定。微信支付有v2和v3两个版本，v3是新的，推荐直接用v3，虽然签名机制复杂点，但安全性和长期维护性更好。下载商户证书，设置APIv3密钥，还有回调地址的配置，这几个环节最容易出错。我见过有人把密钥当成普通密码，随手写在代码里，上线后资金被盗刷，那叫一个惨。密钥必须放在服务端，前端绝不能暴露。

接下来就是核心的支付流程了。用户在微信小程序里发起支付，前端调用wx.requestPayment，这个接口需要后端的签名数据支撑。你需要在服务端统一下单，拿着商户号、订单号、金额这些参数，用API密钥签名，然后返回给前端。这里有个坑，很多新手直接把金额写在前端页面里，这是大忌。真正靠谱的做法是，前端只传订单号，金额由服务端根据数据库里的商品价格重新计算，防止用户篡改。

签名算法这块，我多说两句。v3的签名用的是RSA-SHA256，需要把请求方法、路径、时间戳、随机串这些按规则拼接，然后加密。很多人卡在这一步，不是顺序错了，就是换行符没处理好。建议你直接下载微信官方提供的SDK，别自己造轮子。官方的SDK封装好了签名和验签逻辑，你只需要关注业务代码就行。但用了SDK也不是万事大吉，回调验签必须自己写，防止别人伪造支付结果通知。

回调处理是整个支付流程里最容易出bug的地方。微信服务器会把你支付结果的通知POST到你在商户平台配置的回调URL，你必须正确处理这个通知并返回应答。逻辑很简单，先验签，再校验订单金额和商户订单号，然后更新订单状态，返回一个XML的success给微信。但很多人忽略了幂等性，同一个通知可能发多次，你必须保证重复通知不会导致订单状态被重复更新。还有就是超时处理，微信会有重试机制，你的接口响应时间不能超过3秒，否则微信会认为失败继续重试，导致消息堆积。

测试环节，别用真钱测试，那是真金白银的学费。微信支付提供了沙箱环境，你可以在商户平台申请测试密钥，用虚拟金额跑通整个流程。但沙箱环境也有坑，有些接口字段和正式环境不一样，比如沙箱的商户号是特殊值，签名用的密钥也不同。我建议你准备一套测试脚本，专门用来模拟回调通知，把各种异常情况都覆盖到，比如金额不一致、签名错误、订单不存在，这些情况都要能正确返回错误码。

上线前还有个容易被忽略的点，就是隐私协议和用户授权。小程序审核时，如果你要获取用户手机号或者地址，必须在小程序后台配置隐私保护指引，而且要在前端弹窗让用户同意。支付环节本身不需要额外授权，但如果你在支付前有获取用户信息的操作，就要注意合规性。另外，iOS端和安卓端的行为也有差异，iOS上微信支付必须走微信客户端，如果用户没装微信，会直接提示无法使用，这个你得做好兜底方案。

提醒一句，别光盯着支付成功那一步，退款和售后流程同样重要。用户发起退款，你需要调用微信支付的退款接口，这个接口是异步的，退款结果通过回调通知你。很多开发者上线后才发现，退款没做，用户投诉率飙升，被微信限制提现甚至封禁支付权限。所以，在开发阶段就把退款流程做完，哪怕业务还没跑通，也要把接口预留好。

从申请商户号到正式上线，顺利的话三到五天，但如果你踩了上面任何一个坑，时间就不好说了。我见过最快的团队，两天搞定，也见过最慢的，折腾了一个月还在签名上打转。关键就两点，一是严格按照官方文档来，二是把测试做扎实。别嫌这一步麻烦，支付功能一旦上线出问题，影响的是真金白银和用户信任。

微信小程序支付这块，说白了就是个流程活，没什么高深的技术，但每个环节都得细心。你只要把商户号、签名、回调、测试这四关都过了，上线基本就是顺理成章的事。下次如果有人在群里问支付怎么接入，你可以把这篇文章甩给他，至少能帮他少走一半弯路。