> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Merchant Portal 收银台客制化配置
> 在 Merchant Portal 中配置收银台 Logo、主题样式、子商户样式、发布规则和权限。
你可以在 Merchant Portal 中配置 Waffo 收银台的默认展示样式，无需修改代码。配置保存并发布后，后续新创建的订单会使用最新样式。
API 传参仍然优先于 Portal 配置。如果订单创建请求中传入了 `paymentInfo.cashierAppearance`，该订单会使用 API 中的样式。
## 进入配置页
使用有权限的账号登录 Merchant Portal。
进入 **Checkout → Cashier Customization**。
在左侧配置面板修改 Logo、主题颜色、字体大小和圆角。
在右侧预览区查看收银台效果。
## 上传商户 Logo
在 **Features** 页面上传收银台 Logo。
| 项目 | 说明 |
| ---- | ----------------- |
| 支持格式 | `PNG`、`JPG`、`SVG` |
| 建议尺寸 | `40 x 40 px` |
| 未上传时 | 点击或拖拽上传 |
| 已上传时 | 可以更换或删除 Logo |
## 设置收银台样式
在 **Style** 页面配置收银台主题。你可以一键应用预设主题，也可以按品牌规范自定义颜色和样式参数。
### 颜色字段
| 字段 | 说明 |
| ---------------------- | ------------- |
| Primary Color | 主色调，用于按钮和强调元素 |
| Background Color | 页面背景色 |
| Middle Bg Color | 中间区域背景色 |
| Text Color | 主要文字颜色 |
| Secondary Text Color | 次要文字颜色 |
| Tertiary Text Color | 第三级文字颜色 |
| Danger / Error Color | 危险或错误状态颜色 |
| Info Message Box Color | 信息提示框颜色 |
### 样式参数
| 字段 | 说明 |
| -------------- | ------ |
| Font Size Base | 基础字体大小 |
| Border Radius | 圆角大小 |
## 预览配置效果
修改配置时，右侧预览区会实时显示收银台效果。你可以切换国家或地区，查看不同货币、语言和支付方式下的展示效果。
某些样式字段可能不会在当前预览中立即体现。这通常不是配置未生效，而是因为不同国家、地区或产品类型的收银台页面结构不同。如果当前预览页面不包含对应元素，该样式不会显示。你可以切换到其他国家、地区或产品类型继续检查。
## 配置子商户样式
如果你的账户下有子商户（SubMID），主商户（MID）的配置默认会应用到所有子商户。
如需为子商户单独配置样式：
关闭 **Apply MID config to all SubMIDs**。
在子商户列表中点击 **Edit**。
按与主商户相同的方式配置 **Features** 和 **Style**。
保存后，该子商户状态会显示为 **Customized**。
单独配置子商户不会影响其他子商户。
如需恢复某个子商户使用主商户配置，在子商户列表中点击 **Reset** 并确认。
如果重新启用统一配置，已有的子商户自定义样式会被清除，所有子商户会重新使用主商户配置。
## 保存并发布
页面中的修改只用于当前预览，不会自动应用到实际订单。
点击 **Save & Publish** 后：
1. 当前配置会被保存。
2. 后续新创建的订单会使用最新配置。
如果修改后没有点击 **Save & Publish**，实际下单时仍会使用上一次已保存的配置。
## 权限说明
| 角色 | 查看配置 | 修改并保存 |
| --------------- | ---- | ----- |
| Super Admin | 支持 | 支持 |
| Admin | 支持 | 支持 |
| General | 支持 | 不支持 |
| Read-only | 支持 | 不支持 |
| Dev | 支持 | 不支持 |
| Dispute Manager | 不支持 | 不支持 |