👨💼 商户操作手册
面向一级/二级/三级商户完整操作流程
一、注册与认证
1.1 注册
- 访问
https://pay.yunzexinda.com/user/reg.php - 填写账号、密码、邮箱(邮箱用于找回密码 + 收订单通知)
- 提交后自动开通 2 天试用
1.2 实名认证
- 登录后台 → 我的账号 → 实名认证
- 上传证件 + 填写真实信息
- 等待平台审核(1-24 小时)
- 审核通过后才能使用收单功能
二、系统服务续费
2.1 查看服务期
后台 → 💎 系统服务 → 显示到期时间 + APK 额度
2.2 续费
- 选续费月数(1/3/6/12 个月)
- USDT 支付:
100 USDT/月 - 额外设备:
50 USDT/月/台(超过 3 台时) - 支付后自动延长服务期
注意:服务期到期后,收单、APK 上报、推送全部停止,需续费才恢复。
三、收款码管理
3.1 上传收款码
- 后台 → 收款工具 → 收款码管理 → 新增
- 上传微信/支付宝收款码图片 或 粘贴收款链接
- 填写备注、渠道类型(支付宝个人/商户/聚合等)
- 设置限额:单笔最小/最大金额(0=不限)
- 设置日限额:笔数、总金额
- 可选:设置地区(只收本省)
3.2 开关收款码
列表页每行右侧有「启用/停用」按钮,一键切换。
3.3 渠道类型说明
| 渠道 | 说明 |
|---|---|
alipay_personal | 支付宝个人码 |
alipay_biz | 支付宝商家码 |
wechat_personal | 微信个人码 |
wechat_biz | 微信商家码 |
aggregate_both | 聚合码(支付宝+微信) |
四、APK 激活码
4.1 领取
- 先实名认证通过
- 后台 → 收款工具 → 我的激活码 → 领取
- 每次领 1 个,最多 3 个(可加钱买额度)
4.2 安装 APK
- 下载 APK 到监听手机(安卓)
- 打开 APP → 输入激活码 → 激活
- 授权:通知监听 + 悬浮窗 + 自启
- 保持后台常驻,勿被系统杀
五、订单管理
5.1 我的订单
后台 → 经营数据 → 订单记录。显示:订单号、金额、状态、支付方式。
5.2 下级订单
后台 → 下级商户 → 下级订单。可选「含下级 / 只看我的」切换。
5.3 订单完成流程
客户下单 → 系统分配收款码 → 展示给客户
→ 客户扫码付款 → APK 监听到账
→ 系统自动完成订单 → 触发通知
→ 码 owner 收到邮件/TG 推送
→ 点击「确认到账」→ 完成回调
六、推送配置
6.1 邮件推送
🆕 新版入口:后台左侧「📤 推送中心」→ 邮件推送(
user/mail_push.php)- 后台 → 推送 → 我的推送资料
- 填邮箱(收订单通知)
- 填 SMTP 服务器(可选,用自己邮箱发件)
- 提交 → 上级审批 → 通过后生效
6.2 TG 推送
🆕 新版入口:后台左侧「📤 推送中心」→ 机器人管理(
user/telegram.php)- 找
@userinfobot拿 Chat ID - 后台 → 机器人管理 → 绑定 Bot
- 填 Chat ID
6.3 推送渠道自主选择(新版)
⚠️ 重要变更:订单推送渠道不再由系统「邮件优先、TG 兜底」自动决定,改为 商户自行选择。
入口:后台 → 📤 推送中心 → 机器人管理 → 页面顶部「订单推送渠道」
| 选项 | 含义 | 说明 |
|---|---|---|
| 不推送 | 关闭订单通知 | 订单到账时不主动推送,需进后台手动确认 |
| 仅邮件 | 只发邮件 | 需先在「📧 邮件推送」配置好收件邮箱 |
| 仅 TG | 只推 TG | 需先在「机器人管理」绑定 TG 或配置自建机器人 |
| 邮件 + TG | 双保险 | 两个渠道都推送,推荐无人值守场景 |
⚠️ 标准商户组(gid=4)强制自建
• 选「仅邮件」或「邮件 + TG」→ 必须在「邮件推送」填自己的 SMTP 服务器,平台不会用默认邮箱代发
• 选「仅 TG」或「邮件 + TG」→ 必须在「机器人管理」配置自己的 Bot Token,平台主机器人不会代发
• 配置不全时保存会提示错误,无法生效
• 选「仅邮件」或「邮件 + TG」→ 必须在「邮件推送」填自己的 SMTP 服务器,平台不会用默认邮箱代发
• 选「仅 TG」或「邮件 + TG」→ 必须在「机器人管理」配置自己的 Bot Token,平台主机器人不会代发
• 配置不全时保存会提示错误,无法生效
七、下级商户管理
🌲 树形层级展示:下级商户列表已改为树形排列——二级商户会自动缩进显示在你的下方并带 └ 符号,三级再缩进一层,一眼看清「谁是谁的下级」。平台管理员后台的商户总列表也是同样的树形结构,按层级从高到低排列。
📌 默认分组:新创建的下级自动归属于「标准商户组」,无需手动配置即可收款。
7.1 创建与下发下级
- 后台 → 下级商户 → 创建下级
- 填账号、密码、层级(2 或 3)并提交。
- 提交成功后,系统会弹窗显示账号和密码。请到「下级商户管理」列表,点击对应的【📋 复制登录】按钮,系统会自动生成包含专属登录链接、账号和密码的完整信息。
- 直接将该信息粘贴发送给下级即可,下级必须通过此专属链接才能正常登录(最多 3 级:A→B→C)。
7.2 编辑下级
| 字段 | 说明 |
|---|---|
| 分润比例(rate) | 下级收款时上级拿的 %(0-50) |
| 收款权限(pay) | 关闭后下级无法收款 |
| 增加余额 | 从上级余额划给下级 |
| 扣减余额 | 从下级余额划给上级 |
7.3 审批下级推送资料
下级填的推送资料 → 上级在「下级推送审批」通过/拒绝。
八、账单核对
8.1 下级上传账单
- 下级登录 → 对账单管理 → 上传
- 支持 CSV/TXT/ZIP/XLSX
- 微信账单加密 ZIP 需填密码(在微信「服务通知」里)
- 系统自动解析入库
8.2 上级核对下级账单
- 后台 → 下级商户 → 下级账单核对
- 看到下级所有批次,点「明细」看每条
- 点「对账」→ 系统订单 vs 账单自动匹配
- 核对完 → 点「🗑 核对完删除」(软删)
- 切到「已删除」Tab 可恢复
对账原理:按「金额一致 + 时间差 < 10 分钟」匹配。
- ✅ 匹配 = 系统订单和账单都有
- ⚠️ 系统独有 = 系统有但账单没记录(可能漏单)
- ❌ 账单独有 = 账单有但系统没订单(可能用户直接扫码)
- ✅ 匹配 = 系统订单和账单都有
- ⚠️ 系统独有 = 系统有但账单没记录(可能漏单)
- ❌ 账单独有 = 账单有但系统没订单(可能用户直接扫码)
九、对账中心
后台 → 经营数据 → 对账中心。显示:
- 我的收款(今日/7天/本月/全部)
- 下级代收(下级码收到多少)
- 下级分润给我(上级按 rate 拿多少)
- 我给下级划款
- 下级明细(余额、分润率、收款金额)
十、邮件营销与追踪系统
📌 功能定位
商户向自己的客户群发营销邮件(促销、通知、召回等),并追踪每封邮件的打开 / 点击 / 落地页 / 转化数据。
- 发件人 = 你自己的邮箱(用你的 SMTP)
- 追踪 = 内置 1×1 像素 + 链接重写 + 落地页 SDK
- 数据保留 7 天,需及时导出 CSV
10.1 前置准备 - 配置发件邮箱
必须先做:没配 SMTP 无法发送。
- 后台 → 推送 → 邮件推送(
/user/mail_push.php) - 填写 SMTP 服务器、端口、用户名、密码(授权码)
常用配置参考:
| 邮箱 | SMTP 服务器 | 端口 | 加密 |
|---|---|---|---|
| Gmail | smtp.gmail.com | 465 / 587 | SSL / TLS |
| QQ 邮箱 | smtp.qq.com | 465 | SSL(授权码) |
| 163 邮箱 | smtp.163.com | 465 | SSL(授权码) |
| iCloud | smtp.mail.me.com | 587 | TLS(应用专用密码) |
| Outlook | smtp.office365.com | 587 | TLS |
注意:多数邮箱用 授权码(不是登录密码),要在邮箱设置里生成。
10.2 功能入口
| 页面 | 路径 | 作用 |
|---|---|---|
| 📧 邮件推送 | /user/mail_push.php | 配置 SMTP 发件邮箱 |
| 📣 邮件营销 | /user/mail_marketing/index.php | 活动列表 |
| 📄 邮件模板 | /user/mail_marketing/templates.php | 模板管理 |
| 🔗 追踪接入 | /user/mail_marketing/track_sdk.php | 落地页 SDK 使用说明 |
10.3 创建邮件活动
后台 → 邮件营销 → 点「➕ 新建活动」
填写内容
| 字段 | 说明 |
|---|---|
| 活动名 * | 仅自己可见,方便管理(如「双十一促销」) |
| 邮件主题 * | 收件人看到的标题 |
| 发件人显示名 | 选填(如「XX 商城」),默认显示你的邮箱 |
| 邮件正文 * | HTML 编辑器(支持所有 HTML 标签) |
| 收件人 * | 手动输入 / 从订单买家邮箱勾选 |
正文来源 3 种方式
- 直接编辑:在文本框里写 HTML
- 从模板导入:选已有模板一键填入
- 导入本地 HTML:点「导入 HTML」选本地
.html文件(UTF-8)
收件人来源 2 种方式
- 手动粘贴:每行一个,或用逗号/分号/空格分隔
系统自动去重 + 格式校验,无效邮箱会红字提示 - 从订单拉取:点「加载历史买家邮箱」→ 勾选(支持全选)
取自己名下所有已支付订单的买家邮箱
邮箱验证规则(保存时会强制校验):
- 格式必须合法(正则验证)
- 域名不能是测试/保留域名(example.com、test.com、mailinator 等)
- 域名必须有 MX 或 A 记录(checkdnsrr 检查)
- 不符合的会显示具体原因,需修正后重新提交
10.4 发送控制
创建活动后自动跳到详情页(view.php?id=xxx),在「发送控制」面板里操作。
发送策略 5 种
| 模式 | 批量 | 间隔 | 适用场景 |
|---|---|---|---|
| ⚡ 极速 | 20 封/批 | 0.3 秒/封 | Gmail/QQ 等宽松邮箱 |
| ✅ 标准(推荐) | 10 封/批 | 1 秒/封 | 大多数场景 |
| 🐢 慢速稳发 | 5 封/批 | 3 秒/封 | 收件人 100+ 时推荐,保护账号 |
| 📤 全部一次提交 | 100 封/批 | — | 收件人 ≤100,需页面保持开启 |
| 🔧 自定义 | 自定 | 自定 | 高级用户 |
操作步骤:
- 选发送策略 → 页面底部会显示预计耗时
- 点「🚀 开始发送」→ 实时日志显示每批进度
- 中途可点「⏹ 停止」→ 当前批次完成后停止
- 全部发完 → 页面自动刷新
重要:发送过程中不要关闭页面,否则会中断。
追加收件人
在详情页底部「追加收件人」输入框:
- 选「追加到末尾」(按顺序排队)
- 或选「优先发送」(下一批立即发)
- 点「➕ 添加」→ 系统自动去重
10.5 追踪功能
三种追踪类型(自动)
| 类型 | 触发 | 统计 |
|---|---|---|
| 👁 打开 | 收件人打开邮件(加载 1×1 像素) | 打开率、首次/最后打开时间 |
| 🖱 点击 | 点击邮件里的链接 | 点击率、点击的具体链接 |
| 🌐 落地页 | 跳到目标页后页面加载 SDK | 落地页访问数 |
| ⭐ 转化 | 页面里主动调 mtTrack.event() | 转化数 + 自定义数据 |
追踪明细面板
详情页「追踪明细」区显示每次事件:
- 时间、事件类型、收件人邮箱
- IP 地址
- 点击的具体链接(可点开)
- 设备与浏览器(自动解析成中文,如「手机 · iPhone · 微信内置浏览器」)
支持按类型筛选:全部 / 仅打开 / 仅点击 / 仅落地页 / 仅转化。
追踪数据统计(详情页顶部)
| 指标 | 算法 |
|---|---|
| 收件人总数 | 活动创建时的唯一邮箱数 |
| 已发送 | 成功投递数 |
| 打开率 | 唯一打开人数 ÷ 已发送数 |
| 点击率 | 唯一点击人数 ÷ 已发送数 |
| 落地页访问 | 访问过目标页的去重人数 |
| 转化成功 | 触发自定义事件的去重人数 |
10.6 数据导出
详情页右上角两个导出按钮:
| 按钮 | 导出内容 | 何时用 |
|---|---|---|
| 📥 下载记录 | 收件人列表(含状态/发送时间/是否打开/是否点击/错误) | 长期存档 |
| 📥 导出明细 CSV | 追踪事件明细(时间/事件/邮箱/IP/链接/设备) | 分析用户行为 |
⚠️ 数据保留政策
- 收件人、打开/点击记录只保留 7 天
- 7 天后系统自动清除(
cron_cleanup.php) - 务必及时导出 CSV,否则过期不可恢复
10.7 邮件模板
后台 → 邮件营销 → 邮件模板(templates.php)
创建模板
- 左侧「➕ 新建模板」
- 填模板名 *(必填)
- 填默认邮件主题(选填)
- 编辑 HTML 正文 *(可直接编辑 或 导入本地 .html)
- 点「创建模板」
使用模板
- 方式1:模板列表里点「✈️ 用此模板建活动」→ 跳到 new.php 且预填
- 方式2:创建活动时在正文下拉「从模板导入」选择
模板管理
- 每个模板显示「被引用次数」(多少活动用它)
- 点「查看引用」→ 弹窗列出所有引用的活动
- 删除模板不影响已创建的活动(活动已有自己的副本)
10.8 落地页追踪 SDK(高级)
用途:把追踪装到你自己的落地页上,统计访问和转化。
接入步骤
- 后台 → 邮件营销 → 「追踪接入」(
track_sdk.php)页面有完整说明 - 把 SDK 脚本加到落地页
<head>里:
<script src="https://pay.yunzexinda.com/mail_track/track/sdk.js"></script> - 邮件里的链接会自动加
mt_rid=xxx参数,SDK 检测到就自动追踪
上报转化事件
在落地页支付成功/下单成功时调:
mtTrack.event('purchase', {amount: 199, order: 'ORD123'});
后台就能在「追踪明细 → 仅转化」看到,显示金额和订单号。
原理:
- 邮件里的
<a href>全部被重写成click.php?t=token&url=base64 - 用户点击 → click.php 记录事件 → 302 跳到真实 URL 并加
?mt_rid=token - 落地页 SDK 读
mt_rid,自动上报 landing 事件 - 页面里调
mtTrack.event()上报自定义转化
10.9 常见问题
Q1:点「开始发送」没反应?
- 检查 SMTP 是否配好(mail_push.php)
- 检查有没有未发送的收件人(顶部「未发送」数字)
- F12 Console 看是否有 JS 错误
Q2:发送失败率高?
- 看收件人列表的失败原因(鼠标悬停在红色「失败」标签)
- 常见原因:邮箱不存在 / SMTP 限流 / 被当垃圾邮件
- 换「慢速稳发」模式再试
Q3:打开率是 0?
- 很多邮箱默认屏蔽远程图片(追踪像素就是图片)
- 用户必须「显示图片」才能记录打开
- 所以真实打开率通常比统计值高
Q4:能发多少封?
- 系统限制:单批最多 100,每封间隔 ≥ 0.3 秒
- 实际上限取决于你的 SMTP 服务商(Gmail 免费版 500/天,企业版 2000/天)
- QQ 邮箱每天 50 封左右
Q5:收件人会看到追踪吗?
- 打开追踪:看不见(1×1 透明像素)
- 链接追踪:看不见跳转(302 秒跳)
- 落地页 URL 会多一个
?mt_rid=xxx参数(无感)
十一、常见问题
Q1:下单后客户看不到收款码?
- 检查商户有没有启用的收款码(status=1)
- 检查收款码限额是否覆盖订单金额
- 检查服务期是否有效
Q2:订单已经付款但系统没完成?
- APK 是否在线(查看手机 APP 状态)
- 金额和时间是否在 10 分钟内匹配
- 看码 owner 余额是否不足
Q3:邮件没收到?
- 检查推送资料是否通过审批
- SMTP 配置是否正确
- 看垃圾邮件箱
Q4:下级收不到推送?
- 下级推送资料是否已填 + 上级审批通过
- 订单 pushUid 是否是下级 uid