支付接入指南

微信支付商户号
申请与绑定教程

微信小程序支付功能配置教程。从申请商户号,到取得全部 6 项接入资料

约需 1 个工作日审核 需超级管理员操作

接入资料清单

全部取得后即可交给开发人员完成支付部署,点击卡片可标记为已取得

0 / 6
进度会自动保存在本机浏览器,换设备需重新标记。

开通、停用与注销须知

在正式申请前,先了解开通后如何临时停收、以及永久注销商户号时的正确处理方式,避免资金或商户号出现问题。

只想临时停收

在商户后台关闭「小程序 JSAPI 支付」产品即可临时停用收款,无需注销。想恢复时一键重新开启。

确定永久注销商户号

先结清全部资金,等待 90 天无任何交易后,再申请注销商户号。不建议在中途注销,否则资金清算与历史账单可能受阻。

第一步:申请商户号

登录微信支付商户平台,提交商户资料并完成小程序授权。完成后将取得 商户号 mchid,这是接入资料的第 1 项。

1.1 进入申请接入

打开 微信公众平台 mp.weixin.qq.com, 使用超级管理员账号登录,进入「接入微信支付」,开始填写商户资料。

申请接入微信支付的入口页面
图 1 / 申请接入微信支付入口

1.2 填写商户简称

商户简称是买家直接看到的名字:用户付款后,微信支付账单、支付成功页、银行卡明细里显示的商家名字就是它。

填写申请信息,设置商户简称
图 2 / 填写申请信息与商户简称
简称必须落在执照范围内

商户简称必须包含在营业执照字号或经营范围的文字内,不能出现执照没有的新词。例如执照主体是「上海丰敏金属材料有限公司」,写成「一站式建材五金集采」就会被驳回,因为「一站式」三个字执照里不存在。可参考:丰敏建材五金集采、丰敏金属建材、丰敏金属。

继续填写申请信息
图 3 / 申请信息填写

1.3 受益所有人

系统会询问「是否要添加其他受益所有人」,按股权结构二选一处理。

受益所有人填写界面
图 4 / 受益所有人填写
  • 情况一,法人 100% 独资(只有一个股东):只留 1 个人完全够用,不用额外添加任何人。
  • 情况二,有多名股东,且有人持股达到或超过 25%:必须把符合条件的人全部添加,不能只填法人。

1.4 勾选小程序并授权

勾选要绑定的小程序,提交后记录商户号并允许授权。

勾选小程序并记录商户号
图 5 / 勾选小程序、记录商户号并授权

至此接入资料的第 1 项 mchid 已拿到,点击上方卡片即可标记为已取得。接下来取得剩余 5 项密钥资料。

第二步:取得 6 项接入资料

打开 微信支付商户平台 pay.weixin.qq.com,依次取得公钥、apiV3 密钥、商户私钥证书与证书序列号。

商户平台首页
图 6 / 商户平台首页与 API 安全入口

2.1 公钥 ID 与公钥文件

在 API 安全板块复制并下载微信支付 API 公钥。

  • 复制 PUB_KEY_ID(微信支付 API 公钥 ID)。
  • 下载 pub_key.pem(微信支付 API 公钥文件),保存到本地。

2.2 设置 apiV3 密钥

apiV3 密钥(apiV3Key)是一串 32 位字符串,由你自己设定,用于接口加解密。

设置 apiV3 密钥界面
图 7 / 输入 apiV3 密钥
密钥格式要求

必须是 32 位字符,且只能由大写字母、小写字母、数字组成,不能包含空格、符号、中文。多一个少一个都不行。

示例格式(每次打开随机生成,可以直接使用,也可自定义):

输入两次相同的密钥,再填写商户操作密码与管理员短信验证码,确认提交。

2.3 生成商户私钥证书 apiclient_key.pem

获取商户 API 证书并导出私钥 apiclient_key.pem。需要商户平台与官方证书工具 WXCerUtil 配合操作,分四步完成。

二次确认 apiV3 密钥 申请商户 API 证书
图 8 / 申请商户 API 证书
1 后台申请证书,下载证书工具
商户平台左侧菜单:账户中心 / 账户设置 / API 安全,找到「商户 API 证书」板块,点击【申请证书】。在弹窗里下载官方证书工具 WXCerUtil,保存到本地电脑。
2 工具生成证书请求串
二次确认 apiV3 密钥
图 9 / 二次确认密钥并校验
打开证书工具,选择证书保存文件夹,点【申请证书】,填入商户号与商户全称,下一步。工具自动生成「证书请求串」,点复制。
3 后台提交请求串,获取证书串
回到商户平台弹窗,粘贴请求串,输入商户操作密码与短信验证码,下一步。页面生成「证书串」,点击复制。
4 工具导入证书串,生成全部证书文件
切回证书工具,粘贴证书串,下一步生成证书。点【查看证书文件夹】,解压得到 4 个文件。

解压后的证书文件夹包含:

证书文件夹内容

apiclient_key.pem 商户 API 私钥。
apiclient_cert.pem 商户公钥证书。
apiclient_cert.p12 V2 退款 / 企业付款证书,密码等于你的 mchid。
readme 说明文件。

2.4 保存证书序列号 merchantSerialNumber 和 有效期截止日

顶部点【账户中心】,左侧【账户设置】,【API 安全】,找到「商户 API 证书」板块,点右侧「管理证书」按钮。弹出的列表里第一条就是刚生成的证书,最左侧一长串字母加数字即 merchantSerialNumber(也叫 certSerialNo),全选复制保存。

查看商户证书序列号
图 10 / 查看并复制证书序列号
6 项资料已全部取得

将上述 mchid、PUB_KEY_ID、pub_key.pem、apiV3 密钥、apiclient_key.pem、merchantSerialNumber 一并交给开发人员完成支付接口调试、开发测试。私钥等敏感文件请通过安全渠道传递,勿上传公开仓库或写入客户端代码。

常见问题

关于商户 API 证书的获取、查看与更换,整理自微信支付官方说明。

如何查看商户 API 证书序列号?

登录商户平台,进入【API 安全】/【API 证书】/【查看证书】,即可看到商户 API 证书序列号。

也可使用第三方证书解析工具(如 myssl.com/cert_decode.html)查看证书内容,或用 openssl 命令查看:

$ openssl x509 -in 1900009191_20180326_cert.pem -noout -serial serial=1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C
如何获取商户 API 证书私钥?

商户申请 API 证书时,证书工具会生成商户私钥,并保存在本地证书文件夹的 apiclient_key.pem 中。私钥也可通过工具从商户的 p12 证书中导出。请妥善保管好商户私钥文件。

请勿将私钥文件暴露在公共场合,例如上传到 GitHub 或写入客户端代码。

如何查看商户 API 证书使用量?

登录商户平台,进入 API 安全 / API 证书管理页面,可以看到 API 证书的昨日使用量。

证书到期时,旧证书没作废,能否到期后直接用新证书?

API 证书到期时会自动作废,用过期证书无法调用 v3 接口,所以务必在到期前完成证书更换。

申请新证书不影响旧证书继续使用,微信支持最多 3 份 API 证书同时生效,使用其中任意一份有效证书均可。只要不超过数量限制,是否作废旧证书都可以随时申请新证书。

之前 v2 接口已申请过证书,接入 v3 还要重新申请吗?

不需要,v2 与 v3 共用同一份商户 API 证书。

证书申请后是立即生效吗?可以马上替换旧证书吗?

是的,证书申请后立即生效,可以马上替换旧证书使用。

商户号只有一个证书,怎么作废?

可以先申请一个新证书,再把旧证书作废。

免责声明

本文仅为个人前端、小程序开发学习记录,教程内容仅用于技术 Demo 调试学习。微信支付商户号仅企业 / 个体工商户资质可申请,本站不提供商户号代办、商用系统搭建、商业收款落地、付费开发等任何经营性服务,请勿用于商用经营导向。