交易接入 / 操作与配置
微信扫码:Native 参数申请与配置
先申请微信支付商户号、绑定 AppID,再获取 API v3 密钥、商户证书私钥和微信验签公钥。当前教程只适用于普通商户 Native 扫码。
01 / 准备条件
02 / 分步操作
03 / 结果检查
使用前准备
- 具备微信支付普通商户收款资格,已开通所需产品。
- 能以超级管理员或技术负责人登录微信商户平台。
- 应用已允许“[官方] 微信扫码”,付款人使用微信扫码。
01从准备到结果确认
查看这段动画的完整步骤
- 确认模式
微信 Native:本人收款资格。
商户号与微信 AppID 已绑定。
- 绑定身份
AppID / mchid:已绑定的同一组身份。
当前选择模式的签名/验签资料完整且匹配。
- 准备加密
APIv3 密钥:本人设置的 32 字符值。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
- 准备签名
商户证书 / 私钥:序列号与私钥配套。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
- 准备验签
微信公钥 ID / 公钥:同一份官方公钥资料。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
- 完成验收
Native 新订单:本人扫码付款后核对到账回调。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
02第一步:确认收款模式与应用
查看这段动画的完整步骤
- 登录你自己的 ZOO 站点
登录你自己的 ZOO 站点。示例为分站 https://s.198600.xyz,示例应用名为 vpnceshi。这里的应用名可以换成你的实际业务名。
商户号与微信 AppID 已绑定。
- 打开左侧“商户应用”
打开左侧“商户应用”,找到 vpnceshi,确认所属商户是自己。检查“默认支付范围”是否包含本教程渠道;管理员可点“编辑”调整,普通商户看不到编辑按钮时联系管理员。
当前选择模式的签名/验签资料完整且匹配。
- 打开左侧“系统设置”
打开左侧“系统设置”。管理员先在“选择商户应用”中选 vpnceshi,不要误选“平台默认配置”。普通商户选择自己的应用,不能配置别人的应用。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
- 列表已有“微信支付”时点该行“编辑”
列表已有“微信支付”时点该行“编辑”;没有时点“新增配置”,在“支付平台”选“微信支付”。本教程只处理这一个配置组。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
03第二步:申请商户号与绑定 AppID
查看这段动画的完整步骤
- 打开 微信支付商户平台 ↗
打开 微信支付商户平台 ↗,没有商户号时从“接入微信支付”按真实主体选择普通商户,提交官方要求的主体证照、管理员身份、结算账户和经营场景资料。按官方审核进度完成,不把收款码号当商户号。
商户号与微信 AppID 已绑定。
- 审核通过后登录商户平台
审核通过后登录商户平台,在“账户中心 → 商户信息”查看并保存商户号 mchid。
当前选择模式的签名/验签资料完整且匹配。
- 不是 ZOO 应用 ID
AppID 来自微信公众平台(服务号/小程序等)或开放平台(移动应用),不是 ZOO 应用 ID。没有 AppID 时按官方“mchid 与 appid 申请”文档准备符合场景的应用。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
- 按要求到对应公众/开放平台确认授权
在商户平台的 AppID 账号管理/授权绑定页面绑定你有权使用的 AppID,按要求到对应公众/开放平台确认授权;确认最终状态已绑定。不要从网上复制别人的 wx 开头 ID。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
- 操作 5
检查商户号的产品和经营场景满足 Native 支付使用要求。AppID 绑定与产品开通是两个独立条件。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
04第五步:验证、生效和 Native 验收 · 1
查看这段动画的完整步骤
- 按字段表填入自己取得的资料
按字段表填入自己取得的资料。 保存过的私密字段不会回显;编辑时留空保留原值,填写新值会覆盖旧值。不要把星号或示例文字粘进去。
商户号与微信 AppID 已绑定。
- 点击“验证配置”
点击“验证配置”,阅读提示。验证失败时先按本页排错表修正,不要反复点击保存。验证主要检查凭据、格式或接口连通性,不能证明每种支付产品、到账和回调都已完成。
当前选择模式的签名/验签资料完整且匹配。
- 点击“保存草稿”
点击“保存草稿”。若弹出安全确认,按页面要求在自己的浏览器完成邮箱或双因素验证,勿将验证码发给他人。草稿保存后回到配置列表。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
- 再点击这一行“生效”
复核当前选中的应用、测试/正式环境和回调地址,再点击这一行“生效”。确认状态变为“已生效”。生效影响该应用之后的支付,请在业务允许的时间操作。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
05第五步:验证、生效和 Native 验收 · 2
查看这段动画的完整步骤
- 从已接入的测试商店或面板生成一笔新订单
从已接入的测试商店或面板生成一笔新订单,选择本教程渠道。不要重新使用过期订单,也不要把“返回成功页面”当成到账。检查 ZOO“支付订单”、服务商交易记录和“商户回调”。
商户号与微信 AppID 已绑定。
- 用电脑打开新订单
用电脑打开新订单,选择“[官方] 微信扫码”,确认出现本订单 Native 二维码。
当前选择模式的签名/验签资料完整且匹配。
- 用微信扫一扫核对收款主体及金额后支付
用微信扫一扫核对收款主体及金额后支付,检查微信商户交易记录和 ZOO SUCCESS。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
- 检查业务端回调及充值/发货完成
检查业务端回调及充值/发货完成。换商户证书、公钥或 API v3 密钥后再做同样验收。
配置已生效,本订单 Native 扫码、实际收款及业务回调已验收。
详细操作与条件
第一步:确认收款模式与应用
- 登录你自己的 ZOO 站点。示例为分站
https://s.198600.xyz,示例应用名为vpnceshi。这里的应用名可以换成你的实际业务名。 - 打开左侧“商户应用”,找到
vpnceshi,确认所属商户是自己。检查“默认支付范围”是否包含本教程渠道;管理员可点“编辑”调整,普通商户看不到编辑按钮时联系管理员。 - 打开左侧“系统设置”。管理员先在“选择商户应用”中选
vpnceshi,不要误选“平台默认配置”。普通商户选择自己的应用,不能配置别人的应用。 - 列表已有“微信支付”时点该行“编辑”;没有时点“新增配置”,在“支付平台”选“微信支付”。本教程只处理这一个配置组。
本系统当前接入微信 Native 扫码,不把 H5、JSAPI、服务商子商户或微信个人码当作同一个渠道。服务商教程里的 sp_mchid/sub_mchid 不能直接填到本页商户号。
第二步:申请商户号与绑定 AppID
- 打开 微信支付商户平台 ↗,没有商户号时从“接入微信支付”按真实主体选择普通商户,提交官方要求的主体证照、管理员身份、结算账户和经营场景资料。按官方审核进度完成,不把收款码号当商户号。
- 审核通过后登录商户平台,在“账户中心 → 商户信息”查看并保存商户号 mchid。
- AppID 来自微信公众平台(服务号/小程序等)或开放平台(移动应用),不是 ZOO 应用 ID。没有 AppID 时按官方“mchid 与 appid 申请”文档准备符合场景的应用。
- 在商户平台的 AppID 账号管理/授权绑定页面绑定你有权使用的 AppID,按要求到对应公众/开放平台确认授权;确认最终状态已绑定。不要从网上复制别人的 wx 开头 ID。
- 检查商户号的产品和经营场景满足 Native 支付使用要求。AppID 绑定与产品开通是两个独立条件。
第三步:在 API 安全准备三组资料
API v3 密钥
- 进入“账户中心 → 账户设置 → API 安全”,找到“APIv3 密钥”,按官方规则设置 32 字符密钥,自己安全保存。它不是 API v2 密钥,不是登录密码,也不是证书序列号。
- 官方设置后通常无法再查看原 APIv3 密钥;已经有业务使用时不要随意重置。原值未知需要按官方流程规划轮换,所有使用该商户号的系统都需同步更新。
商户 API 证书与私钥
- 在 API 安全的“申请 API 证书”中使用官方证书工具完成申请;按工具提示生成请求并上传,完成身份确认后下载证书。首次证书下载后妥善备份。
- 保存
apiclient_key.pem(商户 API 证书私钥);从商户后台证书信息或apiclient_cert.pem取得对应的商户 API 证书序列号。私钥与序列号必须来自同一份商户证书。
微信支付公钥模式(适合新手)
- 在 API 安全 → “管理公钥”按官方指引申请/下载微信支付公钥,记录对应微信支付公钥 ID,并保管完整公钥文件。
- 在 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 验收
- 按字段表填入自己取得的资料。 保存过的私密字段不会回显;编辑时留空保留原值,填写新值会覆盖旧值。不要把星号或示例文字粘进去。
- 点击“验证配置”,阅读提示。验证失败时先按本页排错表修正,不要反复点击保存。验证主要检查凭据、格式或接口连通性,不能证明每种支付产品、到账和回调都已完成。
- 点击“保存草稿”。若弹出安全确认,按页面要求在自己的浏览器完成邮箱或双因素验证,勿将验证码发给他人。草稿保存后回到配置列表。
- 复核当前选中的应用、测试/正式环境和回调地址,再点击这一行“生效”。确认状态变为“已生效”。生效影响该应用之后的支付,请在业务允许的时间操作。
- 从已接入的测试商店或面板生成一笔新订单,选择本教程渠道。不要重新使用过期订单,也不要把“返回成功页面”当成到账。检查 ZOO“支付订单”、服务商交易记录和“商户回调”。
- 用电脑打开新订单,选择“[官方] 微信扫码”,确认出现本订单 Native 二维码。
- 用微信扫一扫核对收款主体及金额后支付,检查微信商户交易记录和 ZOO SUCCESS。
- 检查业务端回调及充值/发货完成。换商户证书、公钥或 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 密钥用于解密;商户私钥用于商户请求签名;微信公钥/平台证书用于验证微信响应和通知。
保存之后怎么还是旧配置?
保存草稿不会启用新配置;确认选对应用,再点对应行“生效”,用新订单测试。
编辑时密钥输入框空着,是不是丢了?
私密字段保存后不会回显。已配置字段留空保留原值;重新输入会覆盖。首次新增仍需填写必要参数。
我没有申请到官方账号,可以先照抄教程参数吗?
不能。示例和图中的值都不可用于支付。必须取得自己有权使用的账户和参数;未开通的产品先不要启用。