Skip to content

对接配置 ​

更新时间:2026/10/14 15:49:12

对接配置是商户调用开放接口前必拿的凭证:平台公钥、商户公钥、通信密钥三件套,以及微信 JS 支付需要的域名校验文件。菜单路径:商户中心 → 业务配置 → 对接配置 / 域名校验文件。

对接配置是商户级配置(全商户只有一套,不按应用区分);应用级的配置见应用支付配置。

三件凭证 ​

凭证用途页面行为
平台公钥提供给你用于验证平台返回数据与回调的签名(确认报文确实来自平台)只读展示,可复制
商户公钥你持有配对的私钥、公钥配置到平台,供平台验证你的请求签名可编辑,支持在线「生成密钥对」
通信密钥AES 对称密钥,用于接口报文的加密传输脱敏回显,可编辑,支持在线「生成密钥」

三件凭证如何参与签名与加密,见签名机制;SDK 已内置整套流程,接入方式见接入指南。

在线生成与轮换 ​

没有现成密钥时可以直接在页面上生成,不必本地装工具:

  • 生成密钥对(RSA):生成后私钥只在弹窗中展示一次,关闭后无法找回——立即复制并妥善保存。已有公钥时重新生成会覆盖原密钥,需二次确认;
  • 生成密钥(AES):重新生成通信密钥,已有值时同样二次确认。

轮换的连锁影响

更换商户公钥或通信密钥后,所有使用旧密钥的调用方(业务系统、SDK 实例)都会验签 / 解密失败。轮换前先确认所有对接方都换到了新密钥,再点保存。

保存时只有发生修改的字段会被提交:通信密钥在页面上是脱敏回显的,不改动就不会覆盖服务端的真实值——看到掩码不用紧张,这不是「密钥丢了」。

域名校验文件 ​

微信 JSAPI / 小程序支付要求收款域名下存在校验文件(微信公众平台下载的 MP_verify_xxxx.txt)。菜单路径:商户中心 → 业务配置 → 域名校验文件。

  • 点「上传验证文件」选择微信下载的 txt 文件,只接受 MP_verify_ 开头的命名,其他文件名会被直接拒绝;
  • 上传后系统托管该文件并提供访问;列表可按文件名、验证码检索;
  • 编辑只能改备注,文件名与内容不可改;传错了删除重传即可。

运营端可代管同一份数据(商户管理 → 商户工作台 → 业务配置),两边修改即时生效。

相关链接 ​