云支付系统对接需完成商户资质认证、密钥配置、云函数部署与回调处理四步：先开通微信支付并勾选服务类目，再启用云开发控制台微信支付开关；绑定商户号后通过扫码或网页授权服务商ID 1800008281，并开启JSAPI支付与退款API权限；接着配置APIv3密钥、证书及环境变量；最后部署unifiedOrder云函数实现统一下单，并编写pay/notify函数处理支付结果回调。
云支付系统对接需要完成商户资质认证、密钥配置、云函数部署与回调处理四个核心环节，缺一不可。没有开通微信支付且未绑定商户号的小程序无法调用云调用支付能力，直接调用会返回errCode: 47001错误。
开通云支付能力并绑定商户号
登录云开发控制台 → 进入「设置」→「全局设置」→ 找到「微信支付」开关并启用。这一步必须在小程序管理后台已开通微信支付功能的前提下操作，否则开关为灰色不可点击状态。
【开通前必须确认】小程序已提交微信支付类目审核，并在「小程序管理后台-基本设置-服务类目」中勾选“电商”“生活服务”等对应类目，否则云支付开关无法激活。
绑定商户号时，需输入微信支付平台分配的mchid（10位纯数字），输入后点击「添加」，系统会自动生成待授权的服务商账号ID（固定为1800008281）。
完成微信侧三方授权
方法一：超级管理员扫码授权
打开微信「微信支付商家助手」小程序 → 点击「服务商授权」→ 扫码 → 在授权列表中找到「1800008281 小程序云开发」→ 点击确认。注意：首次加载可能默认显示其他服务商，需手动下拉选择该ID，否则授权失败。
方法二：网页端授权
登录微信支付商户平台 → 进入「账户中心」→「API安全」→「服务商授权」→ 添加服务商 → 输入服务商ID 1800008281 → 提交 → 等待超级管理员在手机端确认。
授权完成后，必须分别进入「我的授权产品」→ 开启「JSAPI支付」和「退款API」权限，缺少任一权限都会导致统一下单或退款接口返回errCode: 48002。
配置云函数支付参数
第一步：准备APIv3密钥与证书
登录微信支付商户平台 → 「账户中心」→「API安全」→ 下载API证书 → 得到apiclient_cert.pem和apiclient_key.pem；使用OpenSSL将私钥转为无密码PKCS#8格式：openssl pkcs8 -topk8 -inform PEM -outform PEM -in apiclient_key.pem -out apiclient_key_plain.pem -nocrypt。
第二步：提取证书序列号
执行命令：openssl x509 -in apiclient_cert.pem -noout -serial | cut -d= -f2 | tr '[:lower:]' '[:upper:]' | tr -d ':'，输出结果即为serial_no，务必复制完整（通常为32位大写十六进制字符串）。
第三步：设置环境变量
在云函数根目录新建.env文件，填入以下内容（注意不要有多余空格）：WECHAT_APPID=wx1234567890abcdefWECHAT_MCHID=1234567890WECHAT_API_V3_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxWECHAT_SERIAL_NO=ABCDEF01234567890123456789012345WECHAT_NOTIFY_URL=https://xxx-yyy-zzz.cloudbase.net/pay/notify
【关键提醒】.env文件必须加入.gitignore，所有敏感字段禁止提交至代码仓库；CloudBase控制台「环境变量」面板中也要同步填写，优先级高于本地.env。
部署统一下单云函数
创建名为unifiedOrder的云函数，安装wx-server-sdk@2.0.2+依赖，在index.js中调用cloud.pay.unifiedOrder接口，传入body、outTradeNo、totalFee、spbillCreateIp、notifyUrl、tradeType（固定填JSAPI）、openid七项必填参数。
其中notifyUrl必须与上一步配置的WECHAT_NOTIFY_URL完全一致，包括协议、域名、路径，且该路径指向一个HTTP触发的云函数（如pay/notify）；若不一致，微信服务器将拒绝发送回调，订单状态永远停留在“未支付”。
云函数返回值中提取payment对象，直接透传给小程序端wx.requestPayment调用，无需二次加工。
编写支付结果回调函数
新建HTTP触发云函数pay/notify，函数内调用cloud.pay.callback解析微信推送的加密通知体，校验签名有效性并提取result_code字段。
若result_code === 'SUCCESS'，则更新数据库订单状态为「已支付」，并执行业务逻辑（如发券、发货）；无论成功与否，函数末尾必须return { errcode: 0 }，否则微信将在48小时内每15分钟重推一次回调，最多重复10次。
