首页 规则中心 支付配置指南 小程序微信支付申请与配置操作流程

小程序微信支付申请与配置完整版操作流程

1 申请小程序微信支付

若您尚未拥有微信支付商户号,需先完成商户号申请与小程序授权绑定,确保后续支付功能正常对接。

1.1 申请新微信支付商户号

商户号是微信支付的核心标识,申请需1-5天(以微信审核进度为准),具体步骤如下:

  1. 登录小程序后台并进入支付申请页

    访问 微信小程序后台,使用管理员账号登录后,在左侧菜单栏点击【微信支付】→【申请接入】。

    微信小程序后台-微信支付申请接入页面

    微信支付申请接入页面(支持已认证服务号、政府/媒体订阅号接入,小程序需先完成认证)

    申请前需准备对应材料(根据主体类型选择):

    • 企业主体:营业执照(彩色扫描件/数码照片)、组织机构代码证(三证合一则无需提供)、对公银行账户(含开户行省市+账号)、法人身份证(彩色扫描件/数码照片)
    • 个体工商户:营业执照、经营者身份证、个人银行账户
    • 政府/事业单位/社会团体:对应主体资质文件、银行账户信息、负责人身份证
  2. 选择“未拥有商户号”并提交申请

    在申请接入页面中,选择“我还没有微信支付商户号”,点击【申请接入】→【注册微信支付商户号】。

    微信支付-注册商户号选择页面

    注册微信支付商户号入口(点击后进入信息填写流程)

  3. 完成商户号申请全流程

    按微信提示依次完成以下步骤,直至商户号激活:

    1. 填写申请信息(主体信息、经营信息、账户信息)
    2. 提交材料并等待微信支付审核(1-5个工作日)
    3. 查收开户邮件(审核通过后,微信发送含商户号、初始密码的邮件)
    4. 验证打款金额(微信向填写的银行账户汇入小额资金,需在商户平台填写金额完成验证)
    5. 登录商户平台签署协议(验证通过后,签署协议即可激活商户号)

申请注意事项

1. 材料需清晰完整,与主体信息一致,避免审核驳回;

2. 打款验证金额通常为0.01-0.99元,需及时查收银行流水;

3. 初始密码需妥善保管,首次登录后建议立即修改并开启安全验证。

1.2 登录微信商户平台添加授权

商户号申请完成后,需将其与小程序APPID绑定,步骤如下:

  1. 登录微信商户平台

    访问 微信商户平台,使用商户号超级管理员账号登录。

  2. 进入APPID授权管理页面

    在左侧菜单栏点击【产品中心】→【APPID授权管理】→【新增授权】(或【关联更多AppID】)。

    微信商户平台-APPID授权管理页面

    APPID授权管理页面(可查看已关联账号、发起新授权申请)

  3. 填写小程序APPID并提交

    在“新增授权”页面中,系统会自动显示当前商户号信息(商户号、商户简称、企业全称),需在“授权绑定的APPID”栏填写目标小程序的APPID,确认APPID类型为“小程序”后,点击【下一步】。

    微信商户平台-新增APPID授权页面

    新增APPID授权页面(需确保APPID已通过微信认证)

授权说明

1. 若商户号与小程序主体一致,提交后直接进入“待小程序管理员确认”状态;

2. 若主体不一致,需先经微信支付平台审核(1-2个工作日),审核通过后再由小程序管理员确认。

1.3 获取小程序APPID

APPID是小程序的唯一标识,授权绑定与后台配置均需使用,获取步骤如下:

  1. 登录小程序后台并进入开发配置页

    访问 微信小程序后台,在左侧菜单栏点击【开发】→【开发配置】。

  2. 复制小程序APPID

    在“开发者ID”栏目中,找到“AppID(小程序ID)”,点击右侧复制按钮(或手动选中复制)。同时可记录“AppSecret(小程序密钥)”(后续开发可能用到,需妥善保管)。

    微信小程序后台-开发者ID配置页面

    开发者ID配置页面(AppID与AppSecret位置示意)

安全提醒

1. AppSecret为私密密钥,仅用于服务器端接口调用,不可在客户端代码中暴露,否则可能导致账号风险;

2. 若忘记AppSecret或怀疑泄露,可点击“重置”按钮重新生成,但需同步更新所有使用该密钥的服务配置。

1.4 登录微信小程序后台确认授权

商户号发起授权申请后,需小程序管理员确认,完成最终绑定,步骤如下:

  1. 进入小程序商户号管理页

    登录 微信小程序后台,点击左侧菜单栏【微信支付】→【商户号管理】。

    微信小程序后台-商户号管理页面

    商户号管理页面(可查看待关联/已关联商户号)

  2. 确认待关联商户号

    在“待关联商户号”栏目中,找到商户号发起的申请,核对“商户号、企业全称、商户简称”等信息,确认无误后点击【确认】。

    微信小程序后台-待关联商户号确认页面

    待关联商户号确认页面(确认后授权关系状态更新为“正常”)

  3. 验证绑定结果

    确认后,在“已关联商户号”栏目中可查看绑定的商户号信息,表明小程序与商户号已成功绑定,可进入后续后台配置环节。

2 小程序微信支付在网站后台的设置

完成商户号与小程序绑定后,需在网站后台配置支付参数(APPID、商户号、密钥、证书等),确保支付功能正常调用。

2.1 检查是否开通JSAPI、Native支付

小程序微信支付核心依赖「JSAPI支付」(小程序内唤起支付)和「Native支付」(生成二维码支付),需先确认商户号已开通这两类产品:

  1. 登录微信商户平台进入产品中心

    访问微信商户平台,登录后点击左侧菜单栏【产品中心】→【产品大全】。

    微信商户平台-产品大全页面

    产品大全页面(可筛选“已开通”“未开通”状态查看支付产品)

  2. 查询支付产品开通状态

    在产品搜索框输入「JSAPI支付」「Native支付」,或在“支付产品”分类下查找对应产品,查看“状态”列:

    • 若显示「已开通」:无需操作,可直接进入后续配置;
    • 若显示「未开通」:点击产品卡片上的【申请开通】,按提示提交申请(通常系统自动审核,1个工作日内完成);
    • 若显示「申请中」:等待审核通过,结果将通过短信/邮件通知。
    微信商户平台-支付产品开通状态查询

    服务商JSAPI支付与Native支付开通状态示意(普通商户显示“JSAPI支付”“Native支付”)

  3. 服务商模式额外操作(若适用)

    若使用服务商模式(商户号为服务商账号),需在【产品中心】→【特约商户授权产品】中,为目标特约商户授权「JSAPI支付」和「Native支付」,确保特约商户可正常使用支付功能。

2.2 设置小程序APPID

将小程序APPID填入网站后台支付配置,步骤如下:

  1. 获取小程序APPID(同1.3步骤)

    登录微信小程序后台→【开发】→【开发配置】→【开发者ID】,复制“AppID(小程序ID)”。

    微信小程序后台-开发者ID获取

    开发者ID页面(AppID位置示意,需复制完整字符,不可遗漏或修改)

  2. 进入网站后台支付配置页面

    登录网站后台(示例:攀登者供应链后台)→【商城】→【在线支付】→【添加支付方式】→选择“微信支付”,进入小程序微信支付配置表单。

    网站后台-微信支付配置入口

    网站后台支付方式选择页面(需选择“微信支付”或“小程序支付”分类)

  3. 填入APPID并保存

    在配置表单中找到「*微信APPID」字段,将复制的小程序APPID粘贴至输入框,确保字符完全一致(区分大小写,无空格)。

    网站后台-微信APPID配置表单

    微信小程序支付配置表单(APPID字段位置示意,带“*”为必填项)

2.3 配置微信支付商户号(MCHID)

商户号(MCHID)是微信支付的收款账户标识,需从已关联的商户号中获取并配置:

  1. 获取商户号(MCHID)

    两种获取方式任选其一:

    • 方式一:从微信小程序后台获取
      登录微信小程序后台→【微信支付】→【商户号管理】→【已关联商户号】,复制“商户号”字段;
    • 方式二:从微信商户平台获取
      登录微信商户平台→【账户中心】→【账户信息】,复制“商户号”字段。
    微信小程序后台-已关联商户号查看

    已关联商户号页面(商户号为纯数字,需完整复制)

  2. 填入商户号至网站后台

    返回网站后台“微信小程序支付”配置表单,找到「*商户号」字段,粘贴获取的商户号,确保无数字遗漏或错误。

    网站后台-商户号配置表单

    商户号配置字段示意(需与微信商户平台显示的商户号完全一致)

2.4 获取公钥、私钥文件

公钥、私钥用于支付接口加密通信,需在微信商户平台生成并下载,步骤如下:

步骤A:申请API证书

  1. 进入API安全页面

    登录微信商户平台→【账户中心】→【账户设置】→【API安全】,点击【申请API证书】按钮。

    微信商户平台-API安全页面

    API安全页面(API证书申请入口,需超级管理员操作)

    注:微信支付推荐使用“权威CA颁发的API证书”,原旧版证书流程已逐步废弃,建议直接申请新版证书。

  2. 允许网页访问剪贴板

    点击【申请API证书】后,弹出“Windows安全警告”弹窗,点击【允许访问】,同意网页读取剪贴板(用于后续证书串传输)。

    Windows安全警告-剪贴板访问

    Windows安全警告弹窗(必须允许访问,否则无法完成证书申请)

  3. 下载证书工具(WXCertUtil.exe)

    在“生成API证书”弹窗的“1.提交请求串”环节,点击【下载证书工具】,下载文件“WXCertUtil.exe”(大小约12.82MB),选择保存路径(建议保存至桌面或专门的证书文件夹)。

    证书工具下载页面

    证书工具下载弹窗(确认下载地址后点击“下载”)

步骤B:使用证书工具生成请求串

  1. 打开证书工具并选择保存路径

    找到下载的“WXCertUtil.exe”文件,双击打开(无需安装),在“证书保存路径”中选择本地文件夹(建议新建“证书工具”文件夹,便于后续查找),点击【申请证书】。

    微信支付证书工具-选择保存路径

    证书工具首页(选择证书保存路径,避免保存至系统盘或临时文件夹)

  2. 填写商户信息并生成请求串

    在“填写商户信息”页面,输入“商户号”和“商户名称”(需与微信商户平台显示完全一致),点击【下一步】。

    证书工具-填写商户信息

    填写商户信息页面(商户号与名称可从微信商户平台“生成API证书”弹窗中复制)

    系统自动生成“请求串”,点击【复制】按钮,保存该请求串(后续需粘贴至微信商户平台)。

步骤C:在微信商户平台提交请求串并完成验证

  1. 粘贴请求串并提交

    返回微信商户平台“生成API证书”弹窗,在“1.提交请求串”的文本框中,粘贴证书工具生成的请求串(确保包含“-----BEGIN CERTIFICATE REQUEST-----”和“-----END CERTIFICATE REQUEST-----”完整标识),点击【下一步】。

    微信商户平台-提交请求串

    提交请求串页面(请求串需完整粘贴,不可修改字符)

  2. 完成安全验证

    进入“安全验证”环节,输入商户号超级管理员的“登录密码”,点击【发送验证码】,接收短信后填入“手机验证码”,点击【确定】。

    微信商户平台-安全验证

    安全验证页面(需超级管理员手机号接收验证码)

  3. 复制证书串并返回证书工具

    验证```html 通过后,系统生成“证书串”,点击【复制证书串】按钮,将证书串保存至剪贴板。返回“微信支付商户平台证书工具”,在“粘贴证书串”页面,粘贴刚复制的证书串,点击【下一步】。

    微信商户平台-复制证书串

    证书串生成页面(需完整复制证书串,包含“-----BEGIN CERTIFICATE-----”标识)

    微信商户平台-复制证书串 微信商户平台-复制证书串 微信商户平台-复制证书串 微信商户平台-复制证书串

步骤D:生成并获取公钥、私钥文件

  1. 证书工具生成证书文件

    在证书工具中粘贴证书串后,点击【下一步】,系统自动生成证书文件,提示“申请证书成功”。点击【查看证书文件夹】,打开保存证书的本地目录。

    证书工具-申请证书成功

    证书生成成功提示(点击“查看证书文件夹”定位文件)

  2. 解压证书压缩包

    证书文件夹中会生成一个以“商户号_日期_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版本配置
V3版本配置

V2版本所需参数:商户密钥 + apiclient_cert.p12证书

步骤1:获取商户密钥(API V2密钥)
  1. 登录微信商户平台→【账户中心】→【账户设置】→【API安全】→【设置APIv2密钥】;

  2. 若未设置过密钥,点击【设置】;若已设置,可点击【修改】(需超级管理员验证);

    微信商户平台-APIv2密钥设置

    APIv2密钥设置页面(需超级管理员操作,支持修改已设置的密钥)

  3. 密钥需为32位随机字符串,可通过随机密码生成工具生成(选择“32位”长度),复制后粘贴至密钥输入框,完成安全验证(短信+密码)后保存;

  4. 保存后需立即记录密钥(微信商户平台后续不再显示完整密钥),若遗忘需重新修改。

  5. apiclient_cert.p12 证书以下

    网站后台-V2版本证书上传
步骤2:上传apiclient_cert.p12证书
  1. 在证书解压文件夹中,找到“apiclient_cert.p12”文件(若解压后无该后缀,需确认文件类型为“PKCS #12证书”);

  2. 返回网站后台“微信小程序支付”配置表单,找到「apiclient_cert.p12证书」上传字段,点击【点击上传】,选择本地的“apiclient_cert.p12”文件,完成上传;

    网站后台-V2版本证书上传

    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主体与商户号主体不一致,需经过微信支付平台审核。关联后,可在不同小程序中使用该商户号收款,资金统一进入商户号对应的银行账户。

配置完成后验证建议

  • 在网站后台发起一笔测试订单,选择微信支付,确认可正常唤起小程序支付界面;
  • 完成测试支付后,登录微信商户平台→【交易中心】→【交易查询】,核对测试订单的支付状态与金额;
  • 若支付失败,查看网站后台支付日志或微信商户平台【交易中心】→【支付失败查询】,根据错误提示排查参数配置问题(如密钥不匹配、证书过期等);
  • 测试完成后,建议删除测试订单或标记为“测试订单”,避免影响正常交易数据统计。