核心用法
本技能为微信小程序支付集成提供一站式云开发（CloudBase）解决方案，完整覆盖支付闭环：unifiedOrder统一下单 → 订单状态管理 → refund原路退款 → 历史订单补录。采用双云函数架构设计——order云函数处理业务逻辑与状态流转，payment云函数封装所有cloud.cloudPay.*调用，实现支付逻辑隔离与可调试性。
关键调用规范包括：
- 支付：使用
cloud.cloudPay.unifiedOrder()，envId必须硬编码字符串（cloud.DYNAMIC_CURRENT_ENV会导致异常），totalFee单位为分（fen），subAppId非子商户模式需移除 - 退款：使用
cloud.cloudPay.refund()，必须双层校验returnCode（CloudBase包装层）和resultCode（微信支付结果），缺一不可 - 部署：强制使用
tcb fn deployCLI部署，DevTools上传会丢失环境变量导致支付落入模拟模式
显著优点
1. 生产级可靠性：所有代码片段均来自真实项目验证，非文档理论推导
2. 踩坑全记录：系统化梳理10+高频故障点，从"模拟模式"到"静默退款失败"均有明确症状-修复对照表
3. 架构最佳实践：强制隔离支付调用层，避免cloud.cloudPay.*分散在多函数中导致的调试噩梦
4. 环境变量安全机制：提供运行时校验代码，缺失WX_MCH_ID时立即失败而非静默降级
潜在缺点与局限性
1. 平台绑定深：完全依赖腾讯云CloudBase生态，迁移至其他云服务商需重构
2. 调试限制：云调用（cloud call）必须通过小程序端、定时触发器或HTTP触发发起，CLI本地调试会报-501001 access_token错误，开发体验受限
3. 子商户模式覆盖有限：subMchId/subAppId相关配置仅提及需移除，复杂分账场景未深入
4. 历史数据修复需临时方案：force_refund等补丁机制需手动清理，存在误操作风险
适合的目标群体
- 小程序开发者：使用CloudBase云开发且需接入微信支付的团队
- 全栈工程师：需要同时处理客户端、云函数、支付配置的技术负责人
- 运维/技术负责人：需审查支付代码安全性、部署合规性的审核角色
- 故障排查场景：遇到"支付进模拟模式""退款不到账""access_token失效"等具体问题的紧急修复
使用风险
1. 资金安全风险：双层校验遗漏会导致订单状态标记为已退款但实际未到账，需严格代码审查
2. 部署陷阱风险：误用DevTools上传会使真实支付降级为模拟模式，生产环境务必使用CLI
3. 环境变量泄露风险：cloudbaserc.json或控制台配置含敏感密钥（WX_MCH_KEY），需纳入密钥管理流程
4. 云调用上下文依赖：非标准触发方式（如CLI直接调用）会导致认证失败，自动化测试需特殊处理
5. 金额单位错误风险：totalFee以分为单位，误传元会导致100倍金额偏差，建议增加前置校验