晋鹏软件

微信小程序在线支付集成

2025-04-24

以下是为您整理的 微信小程序在线支付集成 全流程指南，涵盖技术实现、安全规范、避坑要点及代码示例：

一、集成前准备

1. 资质与配置

步骤	操作说明
注册微信支付商户号	登录微信支付商户平台申请，需企业资质（个体户可申请）
绑定小程序与商户号	小程序后台→「微信支付」→「商户号管理」中关联
获取支付密钥	商户平台→「账户中心」→「API安全」→设置API密钥（32位，需妥善保管）
配置服务器域名	小程序后台→「开发管理」→「服务器域名」添加https://api.mch.weixin.qq.com

二、支付全流程时序图

1. 用户点击支付 → 2. 小程序向业务服务器请求预支付 → 3. 业务服务器调用微信统一下单API → 4. 微信返回prepay_id → 5. 业务服务器生成支付签名返回小程序 → 6. 小程序调起微信支付界面 → 7. 用户输入密码完成支付 → 8. 微信异步通知支付结果 → 9. 业务服务器处理通知并更新订单状态

三、后端核心代码实现（Node.js示例）

1. 统一下单接口

const axios =require('axios');const crypto =require('crypto');// 生成签名函数functioncreateSign(params, key){const stringA = Object.keys(params).sort().map(k=>`${k}=${params[k]}`).join('&');const stringSignTemp = stringA +`&key=${key}`;return crypto.createHash('md5').update(stringSignTemp).digest('hex').toUpperCase();}// 调用统一下单asyncfunctioncreateOrder(orderData){const unifiedOrderUrl ='https://api.mch.weixin.qq.com/pay/unifiedorder';const params ={appid:'小程序APPID',mch_id:'商户号',nonce_str: Math.random().toString(36).substr(2,15),body:'商品描述',out_trade_no:'商户订单号',total_fee:100,// 单位：分spbill_create_ip:'用户IP',notify_url:'支付回调地址',trade_type:'JSAPI',openid:'用户openid'// 从小程序wx.login获取code换取}; params.sign =createSign(params,'API密钥');const response =await axios.post(unifiedOrderUrl,`<xml>${Object.entries(params).map(([k,v])=>`<${k}>${v}</${k}>`).join('')}</xml>`,{headers:{'Content-Type':'text/xml'}});// 解析XML返回prepay_idreturnparseXmlResponse(response.data);}

2. 支付结果通知处理

// 微信回调验证 app.post('/notify',(req, res)=>{let xmlData =''; req.on('data',chunk=> xmlData += chunk); req.on('end',()=>{const result =parseXml(xmlData);const sign = result.sign;delete result.sign;const localSign =createSign(result,'API密钥');if(sign === localSign && result.return_code ==='SUCCESS'){// 更新订单状态为已支付 res.send('<xml><return_code>SUCCESS</return_code><return_msg>OK</return_msg></xml>');}else{ res.status(500).send('签名校验失败');}});});

四、小程序端调用支付

// 获取支付参数 wx.request({url:'https://your-server.com/create-order',method:'POST',data:{productId:123},success(res){const{ timeStamp, nonceStr,package: prepay_id, signType, paySign }= res.data; wx.requestPayment({ timeStamp, nonceStr,package: prepay_id,signType:'MD5',// 或 'HMAC-SHA256' paySign,success:()=> console.log('支付成功'),fail:(err)=> console.error('支付失败', err)});}});

五、安全与避坑指南

常见问题	解决方案
签名错误(SIGNERROR)	检查参数顺序、编码格式、API密钥是否正确，使用微信官方签名工具验证
商户订单号重复	保证out_trade_no全局唯一，建议格式：日期(8位) + 随机字符串(10位)
异步通知丢失	主动调用订单查询接口补偿
跨平台支付兼容	若需同时支持APP/H5，需申请多个商户号或使用服务商模式
用户取消支付	监听fail回调，提示“支付已取消”并允许重新发起

六、高级功能扩展

分账功能
- 使用profit_sharing接口，需商户号开通分账权限，单笔订单最多分账20方
支付即会员
- 支付成功后通过user_id自动绑定会员体系
电子发票
- 集成微信电子发票接口，用户支付后一键开票

七、测试与上线

沙箱环境测试
- 使用微信支付沙箱模拟支付流程
日志监控
- 记录关键节点日志（预支付请求、回调处理），推荐接入Sentry/ELK
灰度发布
- 先对10%用户开放支付功能，验证稳定性

附：官方文档索引

如需进一步调试协助，可提供具体报错信息或业务场景（如虚拟商品/实物商品），针对性提供解决方案。

其它案例

如夏珠宝商城小程序

如夏珠宝商城小程序是您随身的珠宝选购管家。具备智能分类导航，婚饰、日常配饰等珠宝一键速查；支持在线客服 1 对 1 专业答疑，解答材质、保养等疑问。会员积分体系享专属折扣，订单全程可视化追踪，支付安全便捷。同时，个性化推荐算法精准匹配喜好，让挑选珠宝更轻松、更省心。

科奔合創网站-多语言版

在数字化时代，科奔合創原有网站难满足需求。新网站以展示业务、提升用户体验、增强搜索排名为目标。采用简洁科技风设计，融入 3D、视频展示，运用前沿技术适配多设备。上线半年，访客量、页面浏览量显著增长，业务咨询与订单金额攀升，成功提升品牌形象与竞争力。韩文版阿拉伯文版英文版日文版手机版

AI智能体-自动生成民事起诉状

AI智能体，通过微信客服提问，一步步生成民事起诉状

微信文章管理系统系统

微信文章管理系统系统，后台可发表文章，文章分享朋友圈或分享给朋友后，可查看谁看过，看了多长时间，朋友看了文章后，作者会收到微信通知。

粤认证AI智库小程序

AI智库即时解答：关于检测、认证、质量、标准、计量等问题；行业专家在线服务；一站式解决：企业和工程技术人员的有关需求。

西坑集团公司网站

广州西坑企业集团有限公司于1987年成立，经营范围：物业管理、停车场管理、场地房屋租赁等。设有子公司：广州市金贵物业管理有限公司。多年来，广州西坑企业集团有限公司始终秉持着专业、诚信、创新的经营理念，在激烈的市场竞争中不断发展壮大，为地区经济发展和社会进步贡献力量。未来，公司将继续发挥自身优势，积极拓展业务，提升综合实力，创造更多的价值。

能人溯源小程序

能人溯源小程序，为企业、机构等提供二维码溯源服务，编号查询或扫一扫，便知产品、服务来源。

晋鹏自研-基于.NET9的快速开发框架 - 魔法框架

魔法框架1. 技术架构开发语言与框架：基于 .NET9（后端） + Vue3（前端） + ElementPlus（UI组件库），构建高性能、现代化的企业级应用。核心技术集成：内存数据库：提升数据读写速度，降低延迟。缓存管理：优化高频数据访问效率。消息队列：支持异步任务处理（如订单排队、日志记录）。定时任务：自动化执行周期性任务（如数据备份、报表生成）。数据过滤器：灵活处理数据逻辑（如权限过滤...

凯龙物流运单系统

凯龙物流运输单管理系统是一款实用高效的工具，可实现运输单的录入、跟踪与查询等功能。它能优化运输流程，提高调度效率，实时掌握运输状态，确保货物准确及时送达，有效提升凯龙物流的服务质量和运营效益。

鹤山环境教育基地大屏

鹤山环境教育基地大屏是基地的重要展示窗口，通过高清、大尺寸的屏幕，生动呈现生态环境知识、本地环保成果等内容，如播放环保宣传片、展示生物多样性图片等，以直观形象的方式增强公众对环保的认知与理解。

欧雅音响网站

欧雅音响网站是展示其产品与服务的重要平台。网站呈现了各类音响设备，如 AUAL 欧雅 X8-D18A 演出音箱等，还介绍了公司的发展历程、技术实力等。通过该网站，用户可全面了解欧雅音响的产品特点及优势，便于选购与合作

迪素音响中文网站

迪素音响中文网站是展示其产品与品牌的重要平台。网站呈现了各类专业音响设备，如线阵系统、音柱等，还分享了众多成功案例，包括大型活动、景区音效升级等，同时发布公司最新动态，让用户全面了解迪素音响的实力与魅力

Android App 生成工具

可以在网页上通过配置生成Android app

一心健康商城

一心健康商城，是一家专注于健康产品与服务的电商平台，提供丰富多样的健康产品，涵盖健康咨询、健康检测、日常保健等多个领域。商城秉承诚信与质量至上原则，致力于为消费者带来优质、实惠的健康购物体验。

迪素音响英文网站

迪素音响英文网站是其面向全球的官方平台，全面展示各类音响产品及技术。网站提供详细的产品信息、性能参数和应用案例，呈现品牌的专业实力与创新成果，方便国际用户了解、选购产品，促进了迪素音响在全球市场的推广与交流。首页产品展示新闻公司简介质量控制手机版

德舍Bar外卖点餐小程序

德舍 Bar 外卖点餐小程序是一款便捷的点餐工具，用户可通过它浏览丰富菜品、下单支付，还能实时跟踪订单配送进度。商家可管理菜品、订单等，提高运营效率。其界面简洁，操作方便，为用户提供高效的外卖订餐体验。

上海亨元(川汇)诺克药业有限公司网站

上海亨元(川汇)诺克药业有限公司位于周口市经济开发区开元大道与通达路交叉口东200米路南侧。公司占地260亩，建筑面积21.68万平方米，总投资额达10亿元人民币，是河南省重点项目。公司主要生产片剂、胶囊剂、颗粒剂以及保健食品。

小鹏汽车-日历小程序

小鹏汽车用户进入小程序，完成任务可以获得奖励。任务分为问答，看文章，完成所有任务后可以获得正书。

SPLANT智慧园林系统

基于物联网技术、无线通信技术、传感技术、大数据分析等，对园林管理实现智能感知、智能预警、智能分析、智能灌溉及管理，为园林管理者提供精细化培育、可视化管理、智能化决策等方面技术支持。

鹤山环保局信息管理系统

系统包括了：企业信息、项目准入、总量调配、环评审批、验收记录、排污许可证、辐射许可证、零散废水、清洁生产、单位检查、立案执法、应急预案备案、招商考察、地块收储、重点平台、重点项目、固废咨询、三旧改造、局务案审、工业园、污水厂、法律法规和地图管理等功能模块。