址服务地址
| 用途 | 地址 |
|---|
| 商家后台登录 | https://xyd.findhere.cn/admin/merchant/login |
| 商户自助入驻申请 | https://xyd.findhere.cn/admin/merchant/apply |
| 开店引导（审核通过后自动进入） | https://xyd.findhere.cn/admin/merchant/guide |
| 数据看板（登录后首页） | https://xyd.findhere.cn/admin/merchant/dashboard |
| 门店管理（登录后默认落地） | https://xyd.findhere.cn/admin/merchant/store |
| 平台管理后台（平台运营内部使用） | https://xyd.findhere.cn/admin/ |
地址易错点 —— 请认准 /merchant 这一段：
- 商家后台所有地址都形如
/admin/merchant/xxx。漏掉 /merchant 写成 /admin/dashboard，打开的是平台管理后台（需管理员账号，账号体系与商家完全独立），商家账号登录不了。
/admin 前缀也不能省。直接访问 https://xyd.findhere.cn/merchant/login 会被后端当成接口请求，返回 {"code":404,...}。- 两者是两套独立账号体系：平台账号（admin）进不了商家后台，商家账号也进不了平台后台。
提示：建议把登录页 https://xyd.findhere.cn/admin/merchant/login 加入浏览器收藏夹。
流整体流程概览
登录页 /merchant/login已有账号直接登录；新商户点「申请入驻」
① 提交入驻申请 /merchant/apply商户信息 + 手机验证码实名 + 营业执照上传 + 自设登录账号密码 → 获得申请编号 MA…
② 平台审核（1-3 个工作日）运营在「商家管理 → 入驻审核」通过/驳回；通过后自动开通 owner 账号
③ 首次登录强制开店引导 /merchant/guide步骤1 创建门店 → 步骤2 上架商品（可跳过）→ 步骤3 完成
进入商家后台，开始经营工作台 / 门店 / 商品 / 订单 / 运费 / 财务 / 消息 / 核销
1提交入驻申请
入口
商家后台登录页 https://xyd.findhere.cn/admin/merchant/login 底部点「申请入驻」，进入 https://xyd.findhere.cn/admin/merchant/apply。
需准备的材料
| 材料 | 说明 | 必填 |
|---|
| 商户名称 | 店铺对外名称，如「杭州西湖体验店」 | ✓ |
| 商户类型 | 线下商家 / 线上商家（默认线下） | ✓ |
| 经营类目 | 如「茶饮 / 烘焙」，便于平台分类 | 选填 |
| 所属区域 | 省 / 市 / 区 三级行政区划 | 选填 |
| 联系人 | 日常对接人 | 选填 |
| 法人代表 | 营业执照上的法人姓名 | ✓ |
| 手机号 | 接收验证码，用于实名校验 | ✓ |
| 营业执照号 | 统一社会信用代码 | ✓ |
| 营业执照图片 | jpg/jpeg/png/gif/webp，≤ 5MB | ✓ |
| 登录账号 | 4–20 位字母/数字/下划线，审核后用于登录 | ✓ |
| 登录密码 | 至少 6 位，与确认密码一致 | ✓ |
操作要点：① 先填手机号再点「发送验证码」——验证码发送至该手机号（同号 60 秒 / 每日 10 条，5 分钟有效）。② 执照点击上传，成功后显示预览。③ 账号唯一，不可与已有商家重复。④ 提交成功返回申请编号 MA…，请保存用于查询。
进度查询
- 入驻页或登录页「查询申请进度」→ 输入手机号（或申请编号）。
- 待审核（0） / 已通过（1） / 已驳回（2）：驳回会展示平台审核意见，按需修改后重新提交。
- 审核结果同时通过短信通知（上线环境）。
2平台审核（运营侧）
本节供平台运营参考，商户侧只需等待结果。
- 在「商家管理 → 入驻审核」查看申请详情（执照图片、法人、联系方式）。
- 通过：自动开通商家后台 owner 根账号（即申请时自设账号 + 密码），并同步创建 5 个内置角色（店长/运营/财务/客服/只读）。
- 驳回：填写驳回原因，商户侧进度查询可见。
- 审核通过的账号即为入驻时自设账号密码，无需平台另行告知初始密码。
3首次登录与开店引导
登录
审核通过后，用申请时自设的登录账号 + 密码登录。系统检测到 guided = 0 会强制跳转到 /merchant/guide，必须先完成引导才能经营。
开店引导（只需一次，三步）
1
创建门店（必做）
门店名 + 地区三级 + 地址/电话选填；至少一家才能继续。
2
上架商品（可跳过）
商品名 + 售价 + 归属门店 + 描述；类型仅「普通实物」。
说明：门店必须创建；商品可跳过，后续在「商品管理」补上。引导整体仅做一次，完成后 guided=1，再次登录直接进入后台。
模后台模块一览
工作台 Dashboard销售额/订单/商品/门店指标·门店对比·近7日趋势
门店管理门店 CRUD · 地区三级
供应商管理平台公共 + 商家自建
员工管理账号 · 角色 · 负责门店
商品管理多规格SKU·相册·视频·运费·上架
运费模板4 种计费方式 + 区域分段
订单管理发货·批量导入·导出CSV·快递单号
财务对账概览 · 对账 · CSV 导出
进件管理快付(GDKF)商户进件·产品开通·微信配置·分账接收方
消息中心平台公告列表与详情
核销核销记录查询与登记
进快付（GDKF）商户进件
面向需要开通在线收款（微信 / 支付宝扫码、H5、JSAPI 等）的商家。通过「进件管理」与快付云 FastPay 完成商户进件，成功后即可用于交易收款与分账（mode=2 平台代收 / mode=1 实时分账）。入口：商家后台「财务 → 进件管理」/merchant/kuaifu，需 merchant:finance 权限。
进件全流程
① 发起进件选择业务角色 ACQUIRING 收单（默认）/ SPLIT 分账接收方；系统生成外部商户号 outMerCode = 'M' + 商家ID
② 打开 H5 注册页填写资料mrh5.yunfastpay.com/…：法人 / 执照 / 结算账户 / 联系方式，提交后平台审核
③ 查询进件结果（同参数 ≥10s 一次）WAIT 待提交 / DOING 审核中 / FAIL 失败（展示原因，可重发起）/ SUCCESS 成功 → 返回签约地址、userId、applicationId
④ 完成签约打开 sign_url 电子签约；SPLIT 角色还需完成分账协议签约 split_sign_url
⑤ 产品开通 → 微信配置 → 添加分账接收方结算方式+费率；公众号/小程序 AppID+secret（公钥加密传输）；分账接收方名单（mode=1/DELAY 用）
⑥ 商户信息查询查看快付侧资料，证件/手机/结算账号等敏感字段解密后脱敏展示
操作要点
- 发起进件：同一商家不可重复发起——SUCCESS 拦截；WAIT/DOING 需先查询；FAIL 后可重发起，系统自动更换新商户号（
M{商家ID}_时间戳）。
- 查询结果：同参数间隔 ≥10 秒（页面已节流）；成功全量同步签约/分账签约/用户ID/AppID/实名确认状态。
- 产品开通：结算方式（MANUAL 手动等）+ 费率（支付方式 + 计费类型 + 费率值，如 AT / SINGLE_RATE / 0.6%）。
- 微信配置：AppSecret 由系统用快付公钥 RSA 加密传输，不明文出网；同一 AppID 间隔 ≥5s，增量写入不覆盖。
- 分账接收方：≤1 次/秒/AppID，用于实时分账或 DELAY 延迟分账。
- 异步通知：平台推送
POST /api/pay/notify/kuaifu-register 自动验签落库；失败按 0s/15s/30s/5min/30min/60min 重推（约 1h35m）保证最终一致。
进件状态速查
| 字段 | 取值 | 含义 |
|---|
| 进件状态 status | WAIT / DOING / FAIL / SUCCESS | 待提交 / 审核中 / 失败 / 成功 |
| 签约 sign_status | WAIT / DOING / SUCCESS / FAIL | 电子签约进度 |
| 分账签约 split_sign_status | WAIT / DOING / SUCCESS / FAIL | 分账协议签约进度（平台必返回） |
| 产品开通 pro_open_status | 空 / DOING / SUCCESS / FAIL | 产品开通进度 |
| 分账添加 split_add_status | 空 / SUCCESS / FAIL | 分账接收方添加结果 |
常见问题：① 查询提示「操作太频繁」→ 限频 10s，稍后再试；② 进件失败 → 重新发起自动换新商户号；③ 微信配置报 AppID 冲突 → 同 AppID 5s 限频 + 增量写入；④ 进件成功 ≠ 可收款，需依次完成 签约 → 产品开通 →（需微信支付）微信配置 →（需分账）添加分账接收方。
问常见问题
- Q：验证码收不到？ 先确认手机号填写无误、信号正常；同号 60 秒内只能发一条、每日上限 10 条，超限需次日再试；仍未收到请联系平台运营。
- Q：申请被驳回？ 登录页查询进度 → 看审核意见 → 修正后重新提交。
- Q：忘记密码？ 当前入驻账号密码自设，平台运营侧可重置；自助找回待后续版本。
- Q：开店引导能跳过？ 门店必建（至少一家）；商品可跳过，后续补上。引导只需一次。
- Q：商品只能选「普通实物」？ 商家侧类型受平台管控，仅开放普通实物；其他类型由总平台统一管理。
- Q：地区为什么只到区/县？ 商家后台地区已收敛为省/市/区三级，与会员端收货地址粒度一致。
试演示账号（仅本地开发/测试环境）
| 账号 | 密码 | 角色 | 说明 |
|---|
m1 | xyd123456 | 店长(owner) | 20 权限，引导已完成 |
m2 | xyd123456 | merchant_id=2 | 另一商家隔离数据 |
m1op | xyd123456 | 运营 | 负责门店[2]，缺 staff:edit |
m11 | xyd123456 | 店长 | 测试线下门店B（merchant_id=11） |
以上账号仅用于本地开发调试（http://127.0.0.1:9999），生产环境不存在这些账号。正式环境请使用自助入驻流程创建真实商户账号。