我的网站怎么接入码支付 mzf.net.cn?V1/V2 配置教程(附 New API、Sub2API、WordPress 示例)
我的网站已经内置了易支付接口,现在要接入 mzf.net.cn 码支付。mzf.net.cn 提供的是通用易支付接口,所以不需要再写签名和回调代码,只要去 mzf.net.cn 后台拿到密钥信息,再按网站插件支持的版本填参数即可。
对接前先记住两点:
- V1 和 V2 是两套签名机制,不能混填。
- V1 和 V2 的对接地址也不一样,不能填反。
| 版本 | 对接地址 |
|---|---|
| V1(MD5) | https://mzf.net.cn/xpay/epay/ |
| V2(RSA) | https://mzf.net.cn/xpay/epayn/ |
插件支持 V1 就填 V1 地址和 MD5 密钥;支持 V2 就填 V2 地址和 RSA 密钥。如果两者都支持,优先用 V2(RSA),安全性更高。
一、先去 mzf.net.cn 后台拿对接信息
登录 mzf.net.cn 后台,打开 https://mzf.net.cn/user/api,这里能看到对接需要的三类信息:
![图片[1]-网站怎么接入码支付-码支付](https://www.mapay.cn/wp-content/uploads/2026/11/4a8148e1ba20261117041413.png)
- 商户 PID:填到网站插件的商户 ID / PID 里。
- 密钥:V1 是一个 MD5 商户密钥;V2 是商户私钥 + 平台公钥。
- 对接地址:按版本填,V1 用
https://mzf.net.cn/xpay/epay/,V2 用https://mzf.net.cn/xpay/epayn/。
V1 和 V2 的密钥不要混用:
| 版本 | 从 user/api 拿什么 | 用途 |
|---|---|---|
| V1(MD5) | 商户密钥 / KEY | 下单签名和回调验签都用它 |
| V2(RSA) | 商户私钥 + 平台公钥 | 商户私钥签请求,平台公钥验回调 |
二、先看我的网站插件走 V1 还是 V2
打开网站后台的支付插件设置,看密钥字段:
- 只有“商户密钥 / KEY”一个字段 → 走 V1(MD5)。
- 同时有“商户私钥”和“平台公钥”,或者有签名方式可选 MD5 / RSA → 支持 V2(RSA)。
确认后只填对应版本的字段和地址。
三、V1(MD5)怎么填
V1 的对接地址填 https://mzf.net.cn/xpay/epay/。
V1 的签名规则是:参数按 ASCII 字典序排序后拼接,末尾加上商户密钥,取 32 位小写 MD5,sign_type 固定为 MD5。插件已经内置这套逻辑,我只需要把 mzf.net.cn 后台的 MD5 密钥填对。
示例一:WordPress + WooCommerce
在 WooCommerce 的易支付插件里填三项:网关地址、商户 ID、商户密钥。网关地址填 https://mzf.net.cn/xpay/epay/,商户 ID 填 mzf.net.cn 后台的 PID,商户密钥填 https://mzf.net.cn/user/api 里 V1 的 MD5 密钥。保存后启用支付方式,用 0.01 元订单测试。
示例二:ECShop 或通用商城系统
配置项通常是“API 地址 + 商户 ID + 商户密钥”。API 地址填 https://mzf.net.cn/xpay/epay/,商户 ID 填 PID,商户密钥填 V1 的 MD5 密钥。如果插件同时有“回调确认”和“主动查单”,建议都开启,防止回调异常时订单不变。
示例三:New API(默认 MD5 模式)
New API 支付设置里的 Epay 区域,没切换签名方式时默认走 MD5。填 API 地址、商户 ID、Epay 密钥:API 地址填 https://mzf.net.cn/xpay/epay/,Epay 密钥就是 mzf.net.cn 后台 V1 的 MD5 商户密钥。
示例四:Sub2API(EasyPay 实例)
Sub2API 后台 → 设置 → 支付设置,开启“启用支付”,在服务商管理里添加 EasyPay 实例。填 商户 ID(PID)、商户密钥(PKey)、API 地址:API 地址填 https://mzf.net.cn/xpay/epay/,PKey 对应 mzf.net.cn 后台 V1 的 MD5 密钥。
V1 回调通常是 GET 请求,处理完必须返回纯字符串 success,否则 mzf.net.cn 会反复重试。
四、V2(RSA)怎么填
V2 的对接地址填 https://mzf.net.cn/xpay/epayn/。
V2 的签名方式固定为 SHA256withRSA,sign_type 固定为 RSA。密钥分两个方向:商户私钥签请求,平台公钥验 mzf.net.cn 返回的响应和异步通知。V2 通常比 V1 多支持退款、关单等接口。
示例一:New API(RSA 模式)
New API 支付设置里有“签名方式”下拉框时,选 RSA,界面会从“Epay 密钥”变成“商户私钥”和“平台公钥”两个字段。API 地址填 https://mzf.net.cn/xpay/epayn/,两把密钥分别对应 mzf.net.cn 后台的商户私钥和平台公钥,都保存后才能切换。密钥要能被解析,通常支持 PEM 或去掉首尾行的 Base64,格式为 PKCS#8 或 PKCS#1。
示例二:Sub2API 如果版本支持 RSA
Sub2API 的 EasyPay 实例主流配置还是 PID + PKey + API 地址,也就是 V1。只有我的 Sub2API 版本在 EasyPay 实例里额外提供了 RSA 字段或签名方式切换,才按 V2 填:API 地址填 https://mzf.net.cn/xpay/epayn/,并填商户私钥和平台公钥;只有 PKey 一个字段就保持 V1,不要硬填 RSA 密钥。
示例三:支持 V2 的 WooCommerce 插件或主题
如果支付插件里能看到“商户私钥”和“平台公钥”,就按 V2 填:网关地址填 https://mzf.net.cn/xpay/epayn/,两把密钥按插件要求粘贴,不要再填 MD5 密钥。
V2 回调验签用的是平台公钥,不是商户私钥。回调一直验签失败时,先检查平台公钥是否完整、有没有和商户公钥填反。
五、支付能跳转但订单不变,怎么排查
- 地址和密钥是否填对版本。V1 插件必须填
https://mzf.net.cn/xpay/epay/和 MD5 密钥;V2 插件必须填https://mzf.net.cn/xpay/epayn/和商户私钥 + 平台公钥。地址填反、密钥混填,都会导致下单或回调失败。 - 密钥是否和
https://mzf.net.cn/user/api完全一致。V1 检查 MD5 密钥;V2 检查商户私钥和平台公钥是否填反、私钥是否多带了 PEM 头尾。 - 回调地址是否可达。浏览器直接访问插件的
notify_url,确认返回正常,不是 404、登录页或 301/302 跳转。 - mzf.net.cn 是否真的发送异步通知。如果插件支持“主动查单”,打开查单验证一次;查单能查到已支付但回调不来,就去 mzf.net.cn 后台确认通知配置。
六、总结
我的网站接入 mzf.net.cn 码支付,核心就是按版本填对地址和密钥:
- 先去
https://mzf.net.cn/user/api拿商户 PID 和对应版本的密钥。 - V1:对接地址填
https://mzf.net.cn/xpay/epay/,填商户 PID、MD5 商户密钥;New API 填 Epay 密钥,Sub2API 填 PKey。 - V2:对接地址填
https://mzf.net.cn/xpay/epayn/,填商户 PID、商户私钥、平台公钥;New API 切到 RSA 后填两把密钥,Sub2API 仅在界面提供 RSA 字段时按 V2 配置。 - V1 和 V2 的地址、密钥都不要混填。
- 最后用 0.01 元订单验证:能跳转支付,并且回调后订单自动变成“已支付”,才算接入成功。
示例字段只做示意,具体名称以我实际使用的插件和 mzf.net.cn 后台为准。







