配置支付参数
配置支付参数是电子支付的总开关台:微信、支付宝、建行、扫呗、中行、邮储这些渠道,能不能用、用哪个收款账号、哪家门店能用,都在这一页配。它和 支付方式 是两个层次——支付方式决定收银台有没有这个按钮,配置支付参数决定这个按钮点下去钱能不能真的收到。
一、功能概述
菜单位置:连锁管理 → 零售设置 → 配置支付参数(页面地址 /admin/MUPay/unipayconfigpage/)
| 用途 | 说明 |
|---|---|
| 启用渠道 | 左侧「支付类型」列表里逐个开关是否使用、设优先级 |
| 建收款账号 | 「添加账号」给某个支付类型建一个收款账号,填商户号、密钥、证书等渠道参数 |
| 绑分店 | 「分店支付配置」里给每家门店指定用哪个收款账号、充值用哪个账号 |
| 绑终端 | 扫呗、中行、邮储三类渠道可以给具体收银机绑定终端号与令牌 |
二、界面布局说明

| 区域 | 内容 |
|---|---|
| 顶部 | 支付类型: 不限 下拉、关键字(提示「支付类型/分店/账号」)、查询、重置、右上 + 添加账号 |
| 页签 | 支付类型、分店支付配置 |
| 左表 | 支付类型 / 收款方式 / 优先级 / 是否使用 / 聚合支付 |
| 右栏 | 收款账号:选中支付类型后显示该渠道下的账号列表 |
| 分页 | 「共 N 条」(测试账套 33 个支付类型) |
先点左边一行,右边才有内容。 页面默认选中第一行;如果右栏是空的,先确认左表点到某一行。
三、支付类型页签
左表:渠道清单
| 列 | 含义 | 可改 |
|---|---|---|
| 支付类型 | 渠道名称,如「抖音券」「美团券」「建行龙支付」 | 否 |
| 收款方式 | 这个渠道在收银台对应的收款方式名 | 否 |
| 优先级 | 同场景多渠道时的先后顺序,数字越小越优先 | 是,点单元格直接改,必须是数字 |
| 是否使用 | 渠道总开关 | 是,开关即写库 |
| 聚合支付 | 是否走聚合支付通道 | 显示为开关,按当前版本多为只读 |
优先级填了立刻保存,非数字会提示「优先级必须为数字」,空值不保存。
是否使用点一下就生效,没有确认框。关掉后,收银端刷新后这个渠道不可用,但已经同步到 POS 的账号快照可能要重新拉取才失效——关停后请让门店重新登录验证一次。
列表只显示「在后台显示」的支付类型,所以下拉里能选到、列表里却没有的渠道是正常现象。
右栏:收款账号
选中支付类型后,右栏列出这个渠道的收款账号:
| 列 | 含义 |
|---|---|
| 编号 | 账号编号,格式由系统生成(渠道号 + 序号) |
| 收款账号名称 | 给这个账号起的名字,必填 |
| 缺省账号 | 开关,同一渠道只能有一个缺省账号 |
| 是否使用 | 开关,停用后门店选不到这个账号 |
| 在线商城 | 开关,仅部分渠道支持 |
| 操作 | 参数、删除 |
添加账号:点右上「+ 添加账号」,弹出参数窗口。
四、账号参数窗口
窗口顶部三个页签:参数设置、参数JSON格式、终端绑定(后两个按渠道显示)。
参数设置
| 字段 | 说明 |
|---|---|
| 支付类型 | 新增时是下拉,编辑时只读 |
| 账号编号 | 只读,占位提示「保存后自动生成」 |
| 收款账号名称 | 必填,为空提示「收款账号名称不能为空」 |
| 渠道参数 | 按渠道不同而不同,见下表 |
几个常见渠道的参数项:
| 渠道 | 典型参数 |
|---|---|
| 微信(财付通) | AppId、商户号、支付密钥、子商户号、子商户 AppId、证书文件(apiclient_cert.pem / apiclient_key.pem / rootca.pem) |
| 支付宝 | 账号、AppId、支付公有密钥、客户私有密钥、RSA2 私钥 |
| 扫呗 | 商户号、设置方式、AccessToken |
| 建行 | 商户号、分行号、柜台号、Web 服务地址、签名端口、PubKey |
| 招行 | 商户号、商户 Id、应用 ID、公钥、私钥 |
渠道参数没有必填校验和格式校验,填错不会当时报错,要到实际发起支付时才失败。录完请务必用一笔小额真实交易验证。
保存时会把表单里的值原样写入配置;把某个参数清空再保存,等于用空值覆盖原值,不会保留历史值。
安全提醒:密钥、私钥、证书、Token 这类字段在本页是可以查看和复制的(密码框只是遮挡显示,参数JSON页签里也是明文)。能打开本页的账号都能看到这些值,请按生产密钥管理要求控制后台账号范围,离职人员及时回收。
参数JSON格式
只读页签,把当前账号的全部参数按 JSON 预览,方便实施核对字段名与取值。这个预览是明文的。
终端绑定
只有扫呗、中行、邮储三类渠道出现这个页签:
| 列 | 含义 |
|---|---|
| 机器编号 / 机器名称 / 所属分店 | 收银机信息 |
| 主收银机 | 是否主机 |
| 扫呗终端Id / 扫呗AccessToken | 扫呗渠道用 |
| 中行TID | 中行渠道用 |
| 邮储设备号 | 邮储渠道用 |
| 银联终端号 | 银联渠道用 |
要先保存账号,再绑终端,否则提示「请先保存收款账号,再进行终端绑定」。保存成功提示「已保存 N 台终端绑定」。
五、分店支付配置页签
切到「分店支付配置」,列出每家门店在这个支付类型下的使用情况:
| 列 | 含义 |
|---|---|
| 分店编号 / 分店名称 | 门店 |
| 支付类型 | 当前选中的渠道 |
| 是否使用 | 这家店能不能用这个渠道 |
| 收款账号 | 这家店收款用哪个账号 |
| 充值收款账号 | 会员充值时用哪个账号 |
操作要点:
- 分店列表总是全量:每次选中支付类型时,系统会为所有未删除门店补齐一条配置(默认启用、账号为空)。所以第一次进来看到全部门店是正常的。
- 全部启用 / 全部停用:整批改当前支付类型的全部门店,确认框分别是「确认启用当前支付类型的全部分店?」「确认停用当前支付类型的全部分店?」。
- 选账号:点「收款账号」单元格弹选择框,只列启用状态的账号。没选提示「请选择收款账号」,账号不存在或已停用提示「收款账号不存在或未启用」。
- 充值收款账号留空:网页端不会自动回退显示收款账号,留空就是空;实际充值时是否沿用收款账号,以收银端行为为准,建议明确指定。
六、删除账号的限制
账号不是想删就能删,三种情况会被拦:
| 提示 | 原因 |
|---|---|
| 缺省账号不能删除,请先设置其他缺省账号 | 它是这个渠道的缺省账号 |
| 账号已被分店绑定,不能删除 | 有门店的收款账号或充值账号指向它 |
| 账号已绑定终端,不能删除 | 终端绑定表里还有这台账号 |
正确顺序:先改缺省 → 再改分店绑定 → 再解终端 → 最后删。
七、常见问题
问:收银台有微信按钮,但收款失败? 答:按顺序查:① 本页「是否使用」是否打开;② 该门店在「分店支付配置」里是否启用、是否选了收款账号;③ 账号参数(商户号、密钥、证书)是否正确;④ 该账号是否被停用。
问:停用了账号,为什么门店还能收款? 答:支付时系统按账号编号加载配置,不一定实时校验启用状态。停用后要让门店重新拉取配置或重新登录,才能确保失效。涉及资金安全,停用后建议实际下一笔测试单验证。
问:同渠道有多个账号时,门店用哪个? 答:看「分店支付配置」里给这家店指定的收款账号;没指定就用缺省账号。缺省账号同渠道唯一。
问:密钥显示成圆点,能复制吗? 答:密码框只是遮挡显示,值已回填,可以在页面源码或「参数JSON格式」页签里看到明文。请把后台账号当成密钥保管级别来管理。
问:优先级怎么用? 答:数字越小越优先。同一场景多渠道并存时(比如聚合支付里的多个子渠道),按优先级决定默认用哪个。
问:「支付方式」和「配置支付参数」到底谁管谁? 答:支付方式管收银台的按钮和营收口径;配置支付参数管这个按钮背后的商户号、账号与门店绑定。两个都配好,钱才收得进来。
