Skip to content

支付平台配置 ​

更新时间:2026/11/6 21:13:23

平台配置是整站级的全局配置。菜单路径:系统管理 → 系统配置 → 平台配置,共六个页签:端点配置、站点配置、OSS 配置、邮件配置、敏感词策略、MQTT 接入。

其中端点配置与支付链路直接相关(上线必配),其余按需;上线时各页签的取舍见上线检查清单。

每个页签支持 URL 直达:地址后追加 ?tab=(取值 url / website / oss / mail / 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 中重新激活一次才使用新配置。

相关链接 ​