小程序微信支付申请与配置完整版操作流程
1 申请小程序微信支付
若您尚未拥有微信支付商户号,需先完成商户号申请与小程序授权绑定,确保后续支付功能正常对接。
1.1 申请新微信支付商户号
商户号是微信支付的核心标识,申请需1-5天(以微信审核进度为准),具体步骤如下:
-
登录小程序后台并进入支付申请页
访问 微信小程序后台,使用管理员账号登录后,在左侧菜单栏点击【微信支付】→【申请接入】。
微信支付申请接入页面(支持已认证服务号、政府/媒体订阅号接入,小程序需先完成认证)
申请前需准备对应材料(根据主体类型选择):
- 企业主体:营业执照(彩色扫描件/数码照片)、组织机构代码证(三证合一则无需提供)、对公银行账户(含开户行省市+账号)、法人身份证(彩色扫描件/数码照片)
- 个体工商户:营业执照、经营者身份证、个人银行账户
- 政府/事业单位/社会团体:对应主体资质文件、银行账户信息、负责人身份证
-
选择“未拥有商户号”并提交申请
在申请接入页面中,选择“我还没有微信支付商户号”,点击【申请接入】→【注册微信支付商户号】。
注册微信支付商户号入口(点击后进入信息填写流程)
-
完成商户号申请全流程
按微信提示依次完成以下步骤,直至商户号激活:
- 填写申请信息(主体信息、经营信息、账户信息)
- 提交材料并等待微信支付审核(1-5个工作日)
- 查收开户邮件(审核通过后,微信发送含商户号、初始密码的邮件)
- 验证打款金额(微信向填写的银行账户汇入小额资金,需在商户平台填写金额完成验证)
- 登录商户平台签署协议(验证通过后,签署协议即可激活商户号)
申请注意事项
1. 材料需清晰完整,与主体信息一致,避免审核驳回;
2. 打款验证金额通常为0.01-0.99元,需及时查收银行流水;
3. 初始密码需妥善保管,首次登录后建议立即修改并开启安全验证。
1.3 获取小程序APPID
APPID是小程序的唯一标识,授权绑定与后台配置均需使用,获取步骤如下:
-
登录小程序后台并进入开发配置页
访问 微信小程序后台,在左侧菜单栏点击【开发】→【开发配置】。
-
复制小程序APPID
在“开发者ID”栏目中,找到“AppID(小程序ID)”,点击右侧复制按钮(或手动选中复制)。同时可记录“AppSecret(小程序密钥)”(后续开发可能用到,需妥善保管)。
开发者ID配置页面(AppID与AppSecret位置示意)
安全提醒
1. AppSecret为私密密钥,仅用于服务器端接口调用,不可在客户端代码中暴露,否则可能导致账号风险;
2. 若忘记AppSecret或怀疑泄露,可点击“重置”按钮重新生成,但需同步更新所有使用该密钥的服务配置。
2 小程序微信支付在网站后台的设置
完成商户号与小程序绑定后,需在网站后台配置支付参数(APPID、商户号、密钥、证书等),确保支付功能正常调用。
2.1 检查是否开通JSAPI、Native支付
小程序微信支付核心依赖「JSAPI支付」(小程序内唤起支付)和「Native支付」(生成二维码支付),需先确认商户号已开通这两类产品:
-
登录微信商户平台进入产品中心
访问微信商户平台,登录后点击左侧菜单栏【产品中心】→【产品大全】。
产品大全页面(可筛选“已开通”“未开通”状态查看支付产品)
-
查询支付产品开通状态
在产品搜索框输入「JSAPI支付」「Native支付」,或在“支付产品”分类下查找对应产品,查看“状态”列:
- 若显示「已开通」:无需操作,可直接进入后续配置;
- 若显示「未开通」:点击产品卡片上的【申请开通】,按提示提交申请(通常系统自动审核,1个工作日内完成);
- 若显示「申请中」:等待审核通过,结果将通过短信/邮件通知。
服务商JSAPI支付与Native支付开通状态示意(普通商户显示“JSAPI支付”“Native支付”)
-
服务商模式额外操作(若适用)
若使用服务商模式(商户号为服务商账号),需在【产品中心】→【特约商户授权产品】中,为目标特约商户授权「JSAPI支付」和「Native支付」,确保特约商户可正常使用支付功能。
2.2 设置小程序APPID
将小程序APPID填入网站后台支付配置,步骤如下:
-
获取小程序APPID(同1.3步骤)
登录微信小程序后台→【开发】→【开发配置】→【开发者ID】,复制“AppID(小程序ID)”。
开发者ID页面(AppID位置示意,需复制完整字符,不可遗漏或修改)
-
进入网站后台支付配置页面
登录网站后台(示例:攀登者供应链后台)→【商城】→【在线支付】→【添加支付方式】→选择“微信支付”,进入小程序微信支付配置表单。
网站后台支付方式选择页面(需选择“微信支付”或“小程序支付”分类)
-
填入APPID并保存
在配置表单中找到「*微信APPID」字段,将复制的小程序APPID粘贴至输入框,确保字符完全一致(区分大小写,无空格)。
微信小程序支付配置表单(APPID字段位置示意,带“*”为必填项)
2.3 配置微信支付商户号(MCHID)
商户号(MCHID)是微信支付的收款账户标识,需从已关联的商户号中获取并配置:
2.4 获取公钥、私钥文件
公钥、私钥用于支付接口加密通信,需在微信商户平台生成并下载,步骤如下:
步骤A:申请API证书
-
进入API安全页面
登录微信商户平台→【账户中心】→【账户设置】→【API安全】,点击【申请API证书】按钮。
API安全页面(API证书申请入口,需超级管理员操作)
注:微信支付推荐使用“权威CA颁发的API证书”,原旧版证书流程已逐步废弃,建议直接申请新版证书。
-
允许网页访问剪贴板
点击【申请API证书】后,弹出“Windows安全警告”弹窗,点击【允许访问】,同意网页读取剪贴板(用于后续证书串传输)。
Windows安全警告弹窗(必须允许访问,否则无法完成证书申请)
-
下载证书工具(WXCertUtil.exe)
在“生成API证书”弹窗的“1.提交请求串”环节,点击【下载证书工具】,下载文件“WXCertUtil.exe”(大小约12.82MB),选择保存路径(建议保存至桌面或专门的证书文件夹)。
证书工具下载弹窗(确认下载地址后点击“下载”)
步骤B:使用证书工具生成请求串
-
打开证书工具并选择保存路径
找到下载的“WXCertUtil.exe”文件,双击打开(无需安装),在“证书保存路径”中选择本地文件夹(建议新建“证书工具”文件夹,便于后续查找),点击【申请证书】。
证书工具首页(选择证书保存路径,避免保存至系统盘或临时文件夹)
-
填写商户信息并生成请求串
在“填写商户信息”页面,输入“商户号”和“商户名称”(需与微信商户平台显示完全一致),点击【下一步】。
填写商户信息页面(商户号与名称可从微信商户平台“生成API证书”弹窗中复制)
系统自动生成“请求串”,点击【复制】按钮,保存该请求串(后续需粘贴至微信商户平台)。
步骤C:在微信商户平台提交请求串并完成验证
-
粘贴请求串并提交
返回微信商户平台“生成API证书”弹窗,在“1.提交请求串”的文本框中,粘贴证书工具生成的请求串(确保包含“-----BEGIN CERTIFICATE REQUEST-----”和“-----END CERTIFICATE REQUEST-----”完整标识),点击【下一步】。
提交请求串页面(请求串需完整粘贴,不可修改字符)
-
完成安全验证
进入“安全验证”环节,输入商户号超级管理员的“登录密码”,点击【发送验证码】,接收短信后填入“手机验证码”,点击【确定】。
安全验证页面(需超级管理员手机号接收验证码)
-
复制证书串并返回证书工具
验证```html 通过后,系统生成“证书串”,点击【复制证书串】按钮,将证书串保存至剪贴板。返回“微信支付商户平台证书工具”,在“粘贴证书串”页面,粘贴刚复制的证书串,点击【下一步】。
证书串生成页面(需完整复制证书串,包含“-----BEGIN CERTIFICATE-----”标识)
步骤D:生成并获取公钥、私钥文件
-
证书工具生成证书文件
在证书工具中粘贴证书串后,点击【下一步】,系统自动生成证书文件,提示“申请证书成功”。点击【查看证书文件夹】,打开保存证书的本地目录。
证书生成成功提示(点击“查看证书文件夹”定位文件)
-
解压证书压缩包
证书文件夹中会生成一个以“商户号_日期_cert”命名的ZIP压缩包(如“1378611902_20190814_cert.zip”),右键解压该压缩包,得到4个文件:
- apiclient_cert(公钥文件,用于接口加密通信)
- apiclient_key(私钥文件,需妥善保管,不可泄露)
- 证书使用说明(操作指引文档)
- 其他辅助文件(根据证书版本可能略有差异)
证书文件列表(公钥与私钥文件需区分保存,私钥不可公开)
证书安全提醒
1. 私钥文件(apiclient_key)是支付接口的核心安全凭证,需仅保存在服务器或申请证书的本地电脑,不可通过邮件、即时通讯工具传输,避免泄露;
2. 若私钥文件丢失,无法从微信商户平台重新下载,需重新申请API证书;
3. 建议定期(如每6个月)更新API证书,降低安全风险。
2.5 配置API密钥与证书(V2/V3版本)
微信支付API分为V2和V3两个版本,配置参数不同,需根据网站后台支持的版本选择对应配置(推荐优先使用V3版本,安全性更高):
V2版本所需参数:商户密钥 + apiclient_cert.p12证书
步骤1:获取商户密钥(API V2密钥)
-
登录微信商户平台→【账户中心】→【账户设置】→【API安全】→【设置APIv2密钥】;
-
若未设置过密钥,点击【设置】;若已设置,可点击【修改】(需超级管理员验证);
APIv2密钥设置页面(需超级管理员操作,支持修改已设置的密钥)
-
密钥需为32位随机字符串,可通过随机密码生成工具生成(选择“32位”长度),复制后粘贴至密钥输入框,完成安全验证(短信+密码)后保存;
-
保存后需立即记录密钥(微信商户平台后续不再显示完整密钥),若遗忘需重新修改。
-
apiclient_cert.p12 证书以下
步骤2:上传apiclient_cert.p12证书
-
在证书解压文件夹中,找到“apiclient_cert.p12”文件(若解压后无该后缀,需确认文件类型为“PKCS #12证书”);
-
返回网站后台“微信小程序支付”配置表单,找到「apiclient_cert.p12证书」上传字段,点击【点击上传】,选择本地的“apiclient_cert.p12”文件,完成上传;
V2版本证书上传表单(需确保文件格式为.p12,大小不超过规定限制)
步骤3:保存V2版本配置
在配置表单中确认「微信APPID」「商户号」「商户密钥」已填写正确,「apiclient_cert.p12证书」已上传,「API版本」选择“v2”,「渠道状态」设置为“开启”,点击【保存】按钮,完成V2版本配置。
3 常见问题
Q1:申请商户号时提示“材料不符合要求”,如何处理?
A:常见原因及解决办法:① 营业执照扫描件不清晰:重新拍摄,确保文字、公章可辨认,无反光;② 银行账户信息错误:核对开户行省市、支行名称、账号,确保与银行开户信息一致;③ 法人身份证有效期过期:更新身份证后重新上传;④ 主体信息不一致:确保营业执照、法人身份证、银行账户的主体名称完全一致(个体工商户需与经营者信息一致)。修改后重新提交审核,若仍有疑问可联系微信支付客服(95017)咨询。
Q2:商户号与小程序授权绑定后,状态一直显示“待审核”,怎么办?
A:仅当商户号与小程序“主体不一致”时,才会触发微信支付平台审核,审核时间通常为1-2个工作日。若超过3个工作日仍未审核,可:① 检查小程序后台【微信支付】→【商户号管理】是否有审核进度提示;② 登录微信商户平台【产品中心】→【APPID授权管理】查看申请单状态;③ 联系微信支付客服提供申请单编号,查询审核延迟原因。
Q3:配置后调用支付接口提示“证书无效”或“密钥错误”,如何排查?
A:按以下步骤排查:① 确认API版本匹配:V2版本需使用apiclient_cert.p12证书+API V2密钥,V3版本需使用apiclient_key.pem证书+API V3密钥+证书序列号,不可混用;② 检查证书文件:确认上传的证书文件为解压后的原文件,未修改文件名或格式(如将.pem改为.txt);③ 核对密钥与序列号:重新从微信商户平台复制密钥和序列号,排除手动输入错误(建议直接复制粘贴,避免手动录入);④ 检查证书有效期:在微信商户平台【API证书管理】中确认证书未过期,过期需重新申请。
Q4:能否在多个小程序中使用同一个微信支付商户号?
A:可以。一个微信支付商户号最多可关联50个APPID(包括小程序、公众号、APP等),但需满足以下条件:① 商户号已完成实名认证;② 每个关联的APPID需单独发起授权申请并由对应管理员确认;③ 若关联的APPID主体与商户号主体不一致,需经过微信支付平台审核。关联后,可在不同小程序中使用该商户号收款,资金统一进入商户号对应的银行账户。
配置完成后验证建议
- 在网站后台发起一笔测试订单,选择微信支付,确认可正常唤起小程序支付界面;
- 完成测试支付后,登录微信商户平台→【交易中心】→【交易查询】,核对测试订单的支付状态与金额;
- 若支付失败,查看网站后台支付日志或微信商户平台【交易中心】→【支付失败查询】,根据错误提示排查参数配置问题(如密钥不匹配、证书过期等);
- 测试完成后,建议删除测试订单或标记为“测试订单”,避免影响正常交易数据统计。