我在哪里配置 Waffo 收银台的外观?
在 Merchant Portal 中打开 Checkout → Customization。该页面有三个标签页,旁边是实时预览:
三个标签页上的更改都先在本地暂存,按 Save 时一起提交。
我到底能改哪些颜色和尺寸?
Style 标签页提供四个预设主题(Default、Yellow、Dark、Green)作为一键起点,然后是以下单项控件:
在 Text Information 下,你还可以选择头部以 Order Description 还是 Merchant Name 为主,并分别设置字号(14–24 px)。
Amount Display 区块——哪个币种作为主金额显示,以及主/次金额字号——只对已开通的账户出现。如果你看不到它,说明你的账户未开通。
选择预设主题会替换颜色和尺寸,但保留你的 Text Information 和 Amount Display 选择。
我创建订单时,哪个字段控制收银台页面的字号?
paymentInfo.cashierAppearance。它是一个JSON 字符串,携带一个 variables 对象,基础字号就是其中的 fontSizeBase 键:
px 单位。两个值得了解的行为:
- 该值必须是合法 JSON。格式错误的字符串会被丢弃,订单仍会创建——它只会改用你的 Portal 配置渲染,且没有错误提示告诉你原因。
- 只有你发送的键会被应用。你省略的所有内容回退到你的 Portal 配置,再回退到系统默认值。
我的 Portal 样式没有出现在收银台页面上,谁优先?
样式按以下顺序解析,最高优先级在前:
合并是按键进行的,不是全有或全无:只设置了
colorPrimary 的 cashierAppearance 会保留你 Portal 中其他所有键的值。所以如果只有某一个颜色看起来不对而其余正常,先检查你的集成在订单上发了什么,再检查 Portal。
同样的优先级适用于两个品牌字段:
我保存了新样式,它会影响哪些订单?
配置是在收银台页面渲染时读取的,不是在订单创建时冻结的。实际上:- 客户已经打开的收银台页面不受影响——在重新加载之前它保持加载时的样式。
- 保存之后打开的任何收银台页面都会使用新配置,包括你保存之前创建的订单的页面。
我的每个 SubMID 可以有自己的外观吗?
可以。Customization 页面有一个 Configuration Scope 卡片,列出你的 SubMID,由一个开关控制:
开关关闭时,每一行 SubMID 显示 Using MID config 或 Customized。Edit 在同样的三个标签页中打开该 SubMID——你编辑的是该 SubMID 而不是 MID,头部会告诉你这一点。Reset(只对已客制化的 SubMID 提供,且需要确认)会丢弃该 SubMID 自己的 Logo 和样式,使其回到 Using MID config。
两个让人意外的细节:
- 打开一个处于 Using MID config 的 SubMID,会显示 MID 的样式作为起点,但不显示 MID 的 Logo。如果你什么都不改,该 SubMID 保持 Using MID config——不会被悄悄转成客制化的。
- 只有拥有可用支付方式的 SubMID 才会被列出。
如何上传多个 Logo,Logo ID 从哪里来?
在 Features 标签页上传 Logo。页面强制执行的规则:
ID 格式稳定且可预测:
ID 在你的账户内唯一,Logo 一旦保存,其 ID 永不复用。
我有三个 Logo,但最新的是 logo_M5,这是 bug 吗?
不是。序号从该 MID 或 SubMID 上曾使用过的最大编号继续分配,已删除的 Logo 保留其编号。删除logo_M2 和 logo_M3,再上传一个新 Logo,它会成为 logo_M4——这些空缺是刻意永久保留的,这样你在集成中硬编码的 ID 永远不会指向另一张图片。
我能在订单上直接传 Logo,而不是用 Logo ID 吗?
可以,而且两者用同一个字段——brandInfo.cashierLogoUrl。按前缀路由:
Logo URL 优先于 Logo ID,因此传 URL 会在该会话中完全覆盖你的 Portal Logo 列表(你的 Portal 样式配置仍然应用)。找不到可用 Logo 时的回退:
- ID 不存在,或属于已删除的 Logo → 使用默认 Logo。
- 完全没传 Logo → 使用默认 Logo。
- URL 未通过校验 → 丢弃,然后应用同样的回退。
- 任何地方都没配置 Logo → 不显示 Logo。
如果我只有 Logo 或只有名称,头部会显示什么?
四种组合,全部支持:
显示的名称始终是收银台展示名称(依次来自订单、你的 SubMID、你的 MID)。你在 KYB 登记的法定名称在这里永远不会使用。涉及披露脚注的唯一例外,见收银台页面生命周期与收据页面。
实时预览有多准确?
预览在表单旁渲染一个真实的收银台页面,因此颜色、尺寸、Logo、头部布局和支付方式排序都会随编辑更新。其下有 Mobile / Desktop 切换,预览跟随你在 Cashier Ranking 标签页选择的国家,并以你的 Portal 界面语言渲染。 在把差异当作 bug 上报之前,有两个限制值得了解:- 预览无法知道按订单的可用性。真实收银台页面会把暂时不可用、或不适用于特定订单的支付方式置灰或去掉;预览不会,因此真实买家可能看到略少的选项。
- 预览和真实收银台共用同一个单一平铺列表可展示支付方式数量的上限。如果你关闭按国家分组,且去重后的列表超过该上限,预览和真实页面都会回退到按国家分组——越过上限时 Portal 会用确切数字警告你。
我团队里谁能修改这些设置?
保存受单一的收银台客制化编辑权限控制。没有该权限的账户整个页面为只读:预设按钮、颜色选择器、滑块、开关、拖拽手柄和上传全部禁用,没有 Save 按钮,SubMID 列表提供 Detail 而不是 Edit。页面本身仍可查看。 按角色(依 Portal 角色集定义):客制化更改需要 Waffo 审批吗?
不需要。保存即时生效且完全自助——没有审核环节。如果保存被拒绝,那是你输入的值的校验问题,不是审批。仍然没有渲染出你期望的效果?请联系支持,附上订单 ID,以及——如果你在订单上发送了样式——你发送的确切
cashierAppearance 字符串——最常见的原因是订单级的值悄悄覆盖了 Portal。