支付平台配置
平台配置是整站级的全局配置。菜单路径:系统管理 → 系统配置 → 平台配置,共六个页签:端点配置、站点配置、OSS 配置、邮件配置、敏感词策略、MQTT 接入。
其中端点配置与支付链路直接相关(上线必配),其余按需;上线时各页签的取舍见上线检查清单。
每个页签支持 URL 直达:地址后追加
?tab=(取值url/website/oss/sensitive-word/mqtt),如/system/config/platform?tab=mqtt直接打开 MQTT 接入,便于收藏或从工单里贴链接。
端点配置
告诉系统各端的对外访问地址,是支付回调与页面跳转的基础:
| 配置项 | 用途 |
|---|---|
| 管理端访问地址 | 运营管理端基础地址,标准平台第三方登录 client=admin 时生成回调 URL |
| 商户端访问地址 | 商户管理端基础地址,须与商户前端访问源一致并在开放平台白名单登记 |
| 支付网关前端地址 | 收银台 / 网关页面地址,支付页面跳转依赖此项;同时是跳转型平台(支付宝 / 微信公众号)三方登录回调的透传入口 |
| 后端 API 地址 | 后端服务基础 API 地址,通道回调通知等后端发起场景依赖此项,生产环境必须公网可达 |
每个地址右侧的「检查」按钮可验证连通性:后端 API 地址走部署自检探针(验证回调接口可达),其余地址校验 HTTP 可达性,通过时显示延迟。
TIP
各地址填写规范的完整说明与本地开发占位技巧见从部署到第一笔支付 - 第二步。
站点配置
控制系统的对外品牌展示,主要影响登录页与收银台等面向外部的页面:
| 配置项 | 说明 |
|---|---|
| 系统名称 | 全站显示的系统名称 |
| Logo / 暗色 Logo | 浅色与深色主题下的站点 Logo |
| 公司全称 / 电话 / 邮箱 / 微信 | 联系信息展示 |
| ICP 备案信息 / 链接 | 工信部 ICP 备案号与查询链接 |
| 公安备案信息 / 链接 | 公安联网备案号与链接 |
| 支付清算协会备案信息 / 链接 | 支付清算协会备案 |
| 增值电信业务许可信息 / 链接 | 增值电信业务许可证 |
| 版权信息 | 页面底部版权声明 |
未配置备案信息时相关页脚区域不展示,不影响功能。
OSS 配置
平台的文件(站点素材、导入导出文件等)统一走 S3 兼容对象存储,支持 MinIO、阿里云 OSS、腾讯云 COS 等。参数较多(服务端点、路径样式、桶策略等),完整参数说明、三家云厂商配置实例与排错见存储配置。
未配置 OSS 时依赖文件上传的功能不可用,但核心支付流程不受影响。
邮件配置
SMTP 邮件服务,用于找回密码验证码等邮件通知场景:
| 配置项 | 说明 |
|---|---|
| SMTP 服务器 / 端口 | 邮件服务商的 SMTP 地址与端口 |
| 用户名 / 密码 | SMTP 发件账号凭据 |
| 发件人地址 / 发件人昵称 | 邮件中展示的发件方 |
| 加密方式 | 默认 ssl |
| 超时时间(秒) | 默认 10 秒 |
| 启用状态 | 总开关 |
保存后可发送测试邮件验证。未配置时「邮箱找回密码」通道不可用(登录页找回入口会给出提示),账号密码登录不受影响。
敏感词策略
控制敏感词检测的总开关。开启后,商户名称、应用名称等入口字段会经过敏感词校验(词表在「系统管理 → 敏感词管理 → 词库管理」维护,命中记录同目录可查)。一般保持默认开启。
MQTT 接入
设备端播报管道(收款播报(虚拟设备)等设备/终端消息)的接入参数。运维面板部署的用户从网关管理 - MQTT 接入页取值回填:
| 配置项 | 说明 |
|---|---|
| MQTT 接入地址 | 设备端 wss 完整地址,如 wss://mqtt.example.com;TLS 在外层网关终结 |
| 接入账号 | broker 侧的设备接入账号,默认 app-device,对设备消息主题仅有订阅权限 |
| 接入密码 | 与 broker 侧 app-device 账号的密码保持一致;任一侧修改后须两边同步,否则设备无法连接 |
订阅主题无需填写
设备订阅主题由激活接口下发(斜杠形式 daxpay/device/audio/{设备号}),本页不配置主题;不要在客户端自行改成点号形式(Artemis 2.33+ 点号会被转义为单段地址,导致订阅被 ACL 拒绝)。
生效时机
接入参数随设备激活下发到手机 APP;此处配置修改后,已激活设备不会自动更新,需在 APP 中重新激活一次才使用新配置。
相关链接
- 存储配置:OSS 参数详解
- 上线检查清单:各页签的上线取舍
- 配置说明:部署级配置项(数据库、Redis 等)
- 收款播报(虚拟设备):设备播报功能的部署与使用