你可以在 Merchant Portal 中配置 Waffo 收银台的默认展示样式，无需修改代码。配置保存并发布后，后续新创建的订单会使用最新样式。
API 传参仍然优先于 Portal 配置。如果订单创建请求中传入了 paymentInfo.cashierAppearance，该订单会使用 API 中的样式。
进入配置页
登录 Merchant Portal
使用有权限的账号登录 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。
配置样式
按与主商户相同的方式配置 Features 和 Style。
保存配置
保存后，该子商户状态会显示为 Customized。
如果重新启用统一配置，已有的子商户自定义样式会被清除，所有子商户会重新使用主商户配置。
保存并发布
页面中的修改只用于当前预览，不会自动应用到实际订单。
点击 Save & Publish 后：
- 当前配置会被保存。
- 后续新创建的订单会使用最新配置。
如果修改后没有点击 Save & Publish，实际下单时仍会使用上一次已保存的配置。
权限说明
| 角色 | 查看配置 | 修改并保存 |
|---|
| Super Admin | 支持 | 支持 |
| Admin | 支持 | 支持 |
| General | 支持 | 不支持 |
| Read-only | 支持 | 不支持 |
| Dev | 支持 | 不支持 |
| Dispute Manager | 不支持 | 不支持 |
