交易接入 / 操作与配置

微信扫码:Native 参数申请与配置

先申请微信支付商户号、绑定 AppID,再获取 API v3 密钥、商户证书私钥和微信验签公钥。当前教程只适用于普通商户 Native 扫码。

本篇操作教程05 个章节

01 / 准备条件

02 / 分步操作

03 / 结果检查

适用角色
商户用户、平台管理员
操作动画
5 段 · 可播放与逐步查看
内容核验
2026-10-03
使用前准备
  • 具备微信支付普通商户收款资格,已开通所需产品。
  • 能以超级管理员或技术负责人登录微信商户平台。
  • 应用已允许“[官方] 微信扫码”,付款人使用微信扫码。
让 AI 陪你按步骤操作

完整步骤、条件与验收要求。填入自己的业务目标,不要在聊天中粘贴密钥。

查看 / 手动复制完整提示词

关联阅读:商户应用 · 系统设置 · 支付订单 · 商户回调

01

从准备到结果确认

查看这段动画的完整步骤
  1. 确认模式

    微信 Native:本人收款资格。

    商户号与微信 AppID 已绑定。

  2. 绑定身份

    AppID / mchid:已绑定的同一组身份。

    当前选择模式的签名/验签资料完整且匹配。

  3. 准备加密

    APIv3 密钥:本人设置的 32 字符值。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

  4. 准备签名

    商户证书 / 私钥:序列号与私钥配套。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

  5. 准备验签

    微信公钥 ID / 公钥:同一份官方公钥资料。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

  6. 完成验收

    Native 新订单:本人扫码付款后核对到账回调。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

02

第一步:确认收款模式与应用

查看这段动画的完整步骤
  1. 登录你自己的 ZOO 站点

    登录你自己的 ZOO 站点。示例为分站 https://s.198600.xyz,示例应用名为 vpnceshi。这里的应用名可以换成你的实际业务名。

    商户号与微信 AppID 已绑定。

  2. 打开左侧“商户应用”

    打开左侧“商户应用”,找到 vpnceshi,确认所属商户是自己。检查“默认支付范围”是否包含本教程渠道;管理员可点“编辑”调整,普通商户看不到编辑按钮时联系管理员。

    当前选择模式的签名/验签资料完整且匹配。

  3. 打开左侧“系统设置”

    打开左侧“系统设置”。管理员先在“选择商户应用”中选 vpnceshi,不要误选“平台默认配置”。普通商户选择自己的应用,不能配置别人的应用。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

  4. 列表已有“微信支付”时点该行“编辑”

    列表已有“微信支付”时点该行“编辑”;没有时点“新增配置”,在“支付平台”选“微信支付”。本教程只处理这一个配置组。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

03

第二步:申请商户号与绑定 AppID

查看这段动画的完整步骤
  1. 打开 微信支付商户平台 ↗

    打开 微信支付商户平台 ↗,没有商户号时从“接入微信支付”按真实主体选择普通商户,提交官方要求的主体证照、管理员身份、结算账户和经营场景资料。按官方审核进度完成,不把收款码号当商户号。

    商户号与微信 AppID 已绑定。

  2. 审核通过后登录商户平台

    审核通过后登录商户平台,在“账户中心 → 商户信息”查看并保存商户号 mchid。

    当前选择模式的签名/验签资料完整且匹配。

  3. 不是 ZOO 应用 ID

    AppID 来自微信公众平台(服务号/小程序等)或开放平台(移动应用),不是 ZOO 应用 ID。没有 AppID 时按官方“mchid 与 appid 申请”文档准备符合场景的应用。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

  4. 按要求到对应公众/开放平台确认授权

    在商户平台的 AppID 账号管理/授权绑定页面绑定你有权使用的 AppID,按要求到对应公众/开放平台确认授权;确认最终状态已绑定。不要从网上复制别人的 wx 开头 ID。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

  5. 操作 5

    检查商户号的产品和经营场景满足 Native 支付使用要求。AppID 绑定与产品开通是两个独立条件。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

04

第五步:验证、生效和 Native 验收 · 1

查看这段动画的完整步骤
  1. 按字段表填入自己取得的资料

    按字段表填入自己取得的资料。 保存过的私密字段不会回显;编辑时留空保留原值,填写新值会覆盖旧值。不要把星号或示例文字粘进去。

    商户号与微信 AppID 已绑定。

  2. 点击“验证配置”

    点击“验证配置”,阅读提示。验证失败时先按本页排错表修正,不要反复点击保存。验证主要检查凭据、格式或接口连通性,不能证明每种支付产品、到账和回调都已完成。

    当前选择模式的签名/验签资料完整且匹配。

  3. 点击“保存草稿”

    点击“保存草稿”。若弹出安全确认,按页面要求在自己的浏览器完成邮箱或双因素验证,勿将验证码发给他人。草稿保存后回到配置列表。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

  4. 再点击这一行“生效”

    复核当前选中的应用、测试/正式环境和回调地址,再点击这一行“生效”。确认状态变为“已生效”。生效影响该应用之后的支付,请在业务允许的时间操作。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

05

第五步:验证、生效和 Native 验收 · 2

查看这段动画的完整步骤
  1. 从已接入的测试商店或面板生成一笔新订单

    从已接入的测试商店或面板生成一笔新订单,选择本教程渠道。不要重新使用过期订单,也不要把“返回成功页面”当成到账。检查 ZOO“支付订单”、服务商交易记录和“商户回调”。

    商户号与微信 AppID 已绑定。

  2. 用电脑打开新订单

    用电脑打开新订单,选择“[官方] 微信扫码”,确认出现本订单 Native 二维码。

    当前选择模式的签名/验签资料完整且匹配。

  3. 用微信扫一扫核对收款主体及金额后支付

    用微信扫一扫核对收款主体及金额后支付,检查微信商户交易记录和 ZOO SUCCESS。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

  4. 检查业务端回调及充值/发货完成

    检查业务端回调及充值/发货完成。换商户证书、公钥或 API v3 密钥后再做同样验收。

    配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。

详细操作与条件

第一步:确认收款模式与应用
  1. 登录你自己的 ZOO 站点。示例为分站 https://s.198600.xyz,示例应用名为 vpnceshi。这里的应用名可以换成你的实际业务名。
  2. 打开左侧“商户应用”,找到 vpnceshi,确认所属商户是自己。检查“默认支付范围”是否包含本教程渠道;管理员可点“编辑”调整,普通商户看不到编辑按钮时联系管理员。
  3. 打开左侧“系统设置”。管理员先在“选择商户应用”中选 vpnceshi,不要误选“平台默认配置”。普通商户选择自己的应用,不能配置别人的应用。
  4. 列表已有“微信支付”时点该行“编辑”;没有时点“新增配置”,在“支付平台”选“微信支付”。本教程只处理这一个配置组。
只做当前可用的 Native

本系统当前接入微信 Native 扫码,不把 H5、JSAPI、服务商子商户或微信个人码当作同一个渠道。服务商教程里的 sp_mchid/sub_mchid 不能直接填到本页商户号。

第二步:申请商户号与绑定 AppID
  1. 打开 微信支付商户平台 ↗,没有商户号时从“接入微信支付”按真实主体选择普通商户,提交官方要求的主体证照、管理员身份、结算账户和经营场景资料。按官方审核进度完成,不把收款码号当商户号。
  2. 审核通过后登录商户平台,在“账户中心 → 商户信息”查看并保存商户号 mchid。
  3. AppID 来自微信公众平台(服务号/小程序等)或开放平台(移动应用),不是 ZOO 应用 ID。没有 AppID 时按官方“mchid 与 appid 申请”文档准备符合场景的应用。
  4. 在商户平台的 AppID 账号管理/授权绑定页面绑定你有权使用的 AppID,按要求到对应公众/开放平台确认授权;确认最终状态已绑定。不要从网上复制别人的 wx 开头 ID。
  5. 检查商户号的产品和经营场景满足 Native 支付使用要求。AppID 绑定与产品开通是两个独立条件。
第三步:在 API 安全准备三组资料

API v3 密钥

  1. 进入“账户中心 → 账户设置 → API 安全”,找到“APIv3 密钥”,按官方规则设置 32 字符密钥,自己安全保存。它不是 API v2 密钥,不是登录密码,也不是证书序列号。
  2. 官方设置后通常无法再查看原 APIv3 密钥;已经有业务使用时不要随意重置。原值未知需要按官方流程规划轮换,所有使用该商户号的系统都需同步更新。

商户 API 证书与私钥

  1. 在 API 安全的“申请 API 证书”中使用官方证书工具完成申请;按工具提示生成请求并上传,完成身份确认后下载证书。首次证书下载后妥善备份。
  2. 保存 apiclient_key.pem(商户 API 证书私钥);从商户后台证书信息或 apiclient_cert.pem 取得对应的商户 API 证书序列号。私钥与序列号必须来自同一份商户证书。

微信支付公钥模式(适合新手)

  1. 在 API 安全 → “管理公钥”按官方指引申请/下载微信支付公钥,记录对应微信支付公钥 ID,并保管完整公钥文件。
  2. 在 ZOO 选择“微信支付公钥模式”。填入官方公钥 ID 与公钥文本。不要把商户证书的序列号填到公钥 ID。
已有平台证书模式的商户

可以保留平台证书模式。按官方“平台证书下载”指引由技术人员取得微信支付平台证书及其序列号,在 ZOO 选择“平台证书模式”填写。首次获取通常需要官方工具/API;商户 API 证书不是平台证书,不能用 apiclient_cert.pem 顶替。

第四步:ZOO 字段逐项对照
ZOO 字段取自哪里怎么填写
验签方式官方当前使用模式公钥模式或平台证书模式
应用 ID商户号已绑定的 AppID微信 AppID(通常 wx 开头),不是 ZOO ID
商户号账户中心 → 商户信息当前 mchid
API v3 密钥你在 API 安全设置并保管的值完整 32 字符 APIv3 密钥
商户 API 证书序列号当前商户 API 证书与私钥对应的序列号
商户 API 证书私钥apiclient_key.pem完整 PEM 内容,包含 BEGIN/END 和换行
微信支付公钥 ID(公钥模式)API 安全 → 管理公钥对应官方公钥 ID
微信支付公钥(公钥模式)从管理公钥下载完整官方公钥文本
平台证书序列号(证书模式)平台证书下载结果微信支付平台证书序列号,非商户证书序列号
微信支付平台证书(证书模式)官方平台证书工具/API完整平台证书 PEM 内容
两种回调地址要分清

服务商 → ZOO:在当前应用配置列表复制“回调地址”。分站应用通常为 https://s.198600.xyz/api/v1/notify/wechatpay/你的ZOO应用ID;平台默认地址没有应用 ID 后缀。以后台生成地址为准,不照抄占位文本。
ZOO → 你的商店:在商店插件或面板设置 ZOO 的商户回调地址,应用“回调 Origin 白名单”仅填写它的 https://域名(不含路径)。这两个方向不能互换。

第五步:验证、生效和 Native 验收
  1. 按字段表填入自己取得的资料。 保存过的私密字段不会回显;编辑时留空保留原值,填写新值会覆盖旧值。不要把星号或示例文字粘进去。
  2. 点击“验证配置”,阅读提示。验证失败时先按本页排错表修正,不要反复点击保存。验证主要检查凭据、格式或接口连通性,不能证明每种支付产品、到账和回调都已完成。
  3. 点击“保存草稿”。若弹出安全确认,按页面要求在自己的浏览器完成邮箱或双因素验证,勿将验证码发给他人。草稿保存后回到配置列表。
  4. 复核当前选中的应用、测试/正式环境和回调地址,再点击这一行“生效”。确认状态变为“已生效”。生效影响该应用之后的支付,请在业务允许的时间操作。
  5. 从已接入的测试商店或面板生成一笔新订单,选择本教程渠道。不要重新使用过期订单,也不要把“返回成功页面”当成到账。检查 ZOO“支付订单”、服务商交易记录和“商户回调”。
  1. 用电脑打开新订单,选择“[官方] 微信扫码”,确认出现本订单 Native 二维码。
  2. 用微信扫一扫核对收款主体及金额后支付,检查微信商户交易记录和 ZOO SUCCESS。
  3. 检查业务端回调及充值/发货完成。换商户证书、公钥或 API v3 密钥后再做同样验收。
验证结果的含义

微信验证会做 API v3 请求签名与应答验签探针;查询一个不存在的探针订单收到 ORDER_NOT_EXIST 可以被系统判定为验证通过。它不表示 Native 产品权限与真实回调已验收。

常见错误逐项排查
错误/现象优先检查
APPID_MCHID_NOT_MATCH商户号和 AppID 是否已授权绑定;当前应用是否填错
签名或证书序列号错误商户私钥与商户证书序列号是否匹配、文件是否完整
回调解密失败API v3 密钥是否正确,是否拿 API v2 密钥代替
验签公钥/平台证书不匹配选择的验签模式是否与实际文件及对应 ID 一致
证书过期或更换后失败更新对应商户私钥/序列号或平台验签资料,按官方轮换规则处理
扫码入口没有权限确认 Native 场景及产品资格,不能靠开通 H5/JSAPI 顶替
官方资料

资料核对:2026-10-03。本文按 ZOO 当前字段整理,未复制真实账号凭据。服务商的资格、费率和审核结果由服务商决定。

操作结果确认
  • 商户号与微信 AppID 已绑定。
  • 当前选择模式的签名/验签资料完整且匹配。
  • 配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
本页操作视频

与本页主动画使用同一分镜。视频按 1.5× 导出,32 秒;付款与凭据操作由本人完成。

常见问题
还要填公众号 AppSecret 或 OpenID 吗?

当前 Native 扫码配置不要求这两个字段。不要把 JSAPI 教程中的字段擅自套进来。

三种密钥能互相代替吗?

不能。API v3 密钥用于解密;商户私钥用于商户请求签名;微信公钥/平台证书用于验证微信响应和通知。

保存之后怎么还是旧配置?

保存草稿不会启用新配置;确认选对应用,再点对应行“生效”,用新订单测试。

编辑时密钥输入框空着,是不是丢了?

私密字段保存后不会回显。已配置字段留空保留原值;重新输入会覆盖。首次新增仍需填写必要参数。

我没有申请到官方账号,可以先照抄教程参数吗?

不能。示例和图中的值都不可用于支付。必须取得自己有权使用的账户和参数;未开通的产品先不要启用。