开通、停用与注销须知
在正式申请前,先了解开通后如何临时停收、以及永久注销商户号时的正确处理方式,避免资金或商户号出现问题。
在商户后台关闭「小程序 JSAPI 支付」产品即可临时停用收款,无需注销。想恢复时一键重新开启。
先结清全部资金,等待 90 天无任何交易后,再申请注销商户号。不建议在中途注销,否则资金清算与历史账单可能受阻。
第一步:申请商户号
登录微信支付商户平台,提交商户资料并完成小程序授权。完成后将取得 商户号 mchid,这是接入资料的第 1 项。
1.1 进入申请接入
打开 微信公众平台 mp.weixin.qq.com, 使用超级管理员账号登录,进入「接入微信支付」,开始填写商户资料。
1.2 填写商户简称
商户简称是买家直接看到的名字:用户付款后,微信支付账单、支付成功页、银行卡明细里显示的商家名字就是它。
商户简称必须包含在营业执照字号或经营范围的文字内,不能出现执照没有的新词。例如执照主体是「上海丰敏金属材料有限公司」,写成「一站式建材五金集采」就会被驳回,因为「一站式」三个字执照里不存在。可参考:丰敏建材五金集采、丰敏金属建材、丰敏金属。
1.3 受益所有人
系统会询问「是否要添加其他受益所有人」,按股权结构二选一处理。
- 情况一,法人 100% 独资(只有一个股东):只留 1 个人完全够用,不用额外添加任何人。
- 情况二,有多名股东,且有人持股达到或超过 25%:必须把符合条件的人全部添加,不能只填法人。
1.4 勾选小程序并授权
勾选要绑定的小程序,提交后记录商户号并允许授权。
至此接入资料的第 1 项 mchid 已拿到,点击上方卡片即可标记为已取得。接下来取得剩余 5 项密钥资料。
第二步:取得 6 项接入资料
打开 微信支付商户平台 pay.weixin.qq.com,依次取得公钥、apiV3 密钥、商户私钥证书与证书序列号。
2.1 公钥 ID 与公钥文件
在 API 安全板块复制并下载微信支付 API 公钥。
- 复制 PUB_KEY_ID(微信支付 API 公钥 ID)。
- 下载 pub_key.pem(微信支付 API 公钥文件),保存到本地。
2.2 设置 apiV3 密钥
apiV3 密钥(apiV3Key)是一串 32 位字符串,由你自己设定,用于接口加解密。
必须是 32 位字符,且只能由大写字母、小写字母、数字组成,不能包含空格、符号、中文。多一个少一个都不行。
输入两次相同的密钥,再填写商户操作密码与管理员短信验证码,确认提交。
2.3 生成商户私钥证书 apiclient_key.pem
获取商户 API 证书并导出私钥 apiclient_key.pem。需要商户平台与官方证书工具 WXCerUtil 配合操作,分四步完成。
解压后的证书文件夹包含:
apiclient_key.pem 商户 API 私钥。
apiclient_cert.pem 商户公钥证书。
apiclient_cert.p12 V2 退款 / 企业付款证书,密码等于你的 mchid。
readme 说明文件。
2.4 保存证书序列号 merchantSerialNumber 和 有效期截止日
顶部点【账户中心】,左侧【账户设置】,【API 安全】,找到「商户 API 证书」板块,点右侧「管理证书」按钮。弹出的列表里第一条就是刚生成的证书,最左侧一长串字母加数字即 merchantSerialNumber(也叫 certSerialNo),全选复制保存。
将上述 mchid、PUB_KEY_ID、pub_key.pem、apiV3 密钥、apiclient_key.pem、merchantSerialNumber 一并交给开发人员完成支付接口调试、开发测试。私钥等敏感文件请通过安全渠道传递,勿上传公开仓库或写入客户端代码。
常见问题
关于商户 API 证书的获取、查看与更换,整理自微信支付官方说明。
如何查看商户 API 证书序列号?
登录商户平台,进入【API 安全】/【API 证书】/【查看证书】,即可看到商户 API 证书序列号。
也可使用第三方证书解析工具(如 myssl.com/cert_decode.html)查看证书内容,或用 openssl 命令查看:
如何获取商户 API 证书私钥?
商户申请 API 证书时,证书工具会生成商户私钥,并保存在本地证书文件夹的 apiclient_key.pem 中。私钥也可通过工具从商户的 p12 证书中导出。请妥善保管好商户私钥文件。
请勿将私钥文件暴露在公共场合,例如上传到 GitHub 或写入客户端代码。
如何查看商户 API 证书使用量?
登录商户平台,进入 API 安全 / API 证书管理页面,可以看到 API 证书的昨日使用量。
证书到期时,旧证书没作废,能否到期后直接用新证书?
API 证书到期时会自动作废,用过期证书无法调用 v3 接口,所以务必在到期前完成证书更换。
申请新证书不影响旧证书继续使用,微信支持最多 3 份 API 证书同时生效,使用其中任意一份有效证书均可。只要不超过数量限制,是否作废旧证书都可以随时申请新证书。
之前 v2 接口已申请过证书,接入 v3 还要重新申请吗?
不需要,v2 与 v3 共用同一份商户 API 证书。
证书申请后是立即生效吗?可以马上替换旧证书吗?
是的,证书申请后立即生效,可以马上替换旧证书使用。
商户号只有一个证书,怎么作废?
可以先申请一个新证书,再把旧证书作废。