> ## 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.

# 在一个账户下运营多个品牌

> 如何使用 SubMID 在一个 Waffo 账户下运营多个品牌或业务线：每个品牌各自的收银台名称和 logo、哪一级配置优先、在你配置任何内容之前会发生什么、哪些内容会被固定、某些支付会额外收集的信息，以及报表中的 USD 金额是如何换算的。

本页面向在多个品牌、店面或业务线下销售的账户。页面级样式控制项由"客制化收银台页面"文档覆盖；本页讲的是让这些控制项
按品牌产生差异的账户结构。

## 我有多个品牌，每个品牌都需要单独的 Waffo 账户吗？

不需要，也不需要更改你的商户类型。支持的结构是保留你现有的 MID，并**为每个品牌或业务线挂一个 SubMID**。每个 SubMID
可以拥有自己面向顾客的身份，而你的账户、合约和报表仍集中在一处。

SubMID 能给你什么：

| 每个 SubMID | 效果 |
| - | - |
| 收银台显示名称 | 你的买家在收银台页面和收据上看到的名称 |
| 商户 logo | 自己的 logo 列表，与 MID 的分开上传 |
| 收银台样式 | 自己的颜色和尺寸，或继承 MID 的 |
| 支付方式排序 | 自己的排序，按国家 |
| 订单创建 | 订单可以针对 MID 创建，也可以针对 SubMID 创建 |

## SubMID 订单在收银台上显示哪个名称和 logo？

按优先级从高到低解析：

| 优先级 | 来源 |
| - | - |
| 1 | 你在订单上传的值——`brandInfo.cashierDisplayName`（最多 128 个字符）和 `brandInfo.cashierLogoUrl`（最多 512 个字符） |
| 2 | **SubMID** 配置的值 |
| 3 | **MID** 配置的值 |

所以 MID 充当兜底身份：一个没有任何配置的 SubMID 会展示 MID 的名称和 logo，而不是什么都不展示。如果两级都没有配置
显示名称，商户名称字段会直接隐藏——不会用你 KYB 登记的法定名称替代。

两个订单级字段都是按会话生效的，不会更改任何已保存的内容。当品牌是单笔交易的属性而不是某条业务线的属性时，它们是
合适的工具。

## MID 总是充当兜底身份吗？

对于标准商户账户，是的：SubMID 上没有自己显示名称的订单会显示 MID 的名称。有一个例外——设置为**机构商户**的账户
**只从 SubMID** 解析显示名称。如果该 SubMID 没有配置显示名称，商户名称字段会被隐藏，而不是回退到账户级。

如果你不确定你的账户适用哪一种，可以在测试收银台页面上检查一个没有任何配置的 SubMID 是否显示你的账户级名称。

## 我的品牌是按交易变化的，不是按业务线，还需要 SubMID 吗？

不一定。如果决定因素是单笔订单而不是持久的业务线，就改为在订单上传身份：

| 字段 | 限制 | 说明 |
| - | - | - |
| `brandInfo.cashierDisplayName` | 128 个字符 | 覆盖该会话中配置的显示名称 |
| `brandInfo.cashierLogoUrl` | 512 个字符 | 接受图片 URL（`http://`/`https://`）或预先创建的 logo ID（`logo_…`） |

任一字段的无效值会被**静默丢弃**，订单仍然会创建——以你配置的身份渲染，不会有错误来解释差异。请校验你发送的内容。

logo ID 的形式以及 ID 如何按 MID 和按 SubMID 分配，见"客制化收银台页面"文档。

当差异是持久的（一个品牌、一个店面、一条有自己外观和自己报表切分的业务线）时使用 SubMID；当差异是按交易的时使用订单字段。

## 我准备挂第一个 SubMID，现有流量会有变化吗？

不会。在你于 SubMID 级配置任何内容之前，一切仍然解析到你现有的 MID 配置——相同的收银台名称、相同的 logo、相同的样式、
相同的排序。挂上 SubMID 本身不是顾客可见的变化；对它进行配置才是。

在 Portal 中，每个 SubMID 都带有状态列出，你可以一眼看到哪些已经产生了差异：

| 标签 | 含义 |
| - | - |
| **Using MID config** | 该级尚未配置任何内容 |
| **Customized** | 该 SubMID 有自己的 logo 或样式 |

对已自定义的 SubMID 执行 **Reset** 会将其恢复为 Using MID config。

## 开始使用 SubMID 之后，哪些内容会被固定？

结构。一旦 SubMID 完成了初始入驻步骤，或处理过真实交易，该安排就会**被锁定且不可逆**——之后你无法把该 SubMID 撤回并入 MID。

对规划的影响：在上线之前而不是之后决定你的品牌到 SubMID 的映射。之后再添加更多 SubMID 没有问题；合并现有的则不行。

## 每个品牌能有不同的支付方式集合和不同的排序吗？

排序可以——支付方式排序按国家配置，可以按 SubMID 单独设置，独立于 MID。至于哪些支付方式存在，由你的协议决定，
而不是由 SubMID 结构决定，所以 SubMID 不能让你账户没有的支付方式变为可用。

排序、分组和可用性如何相互作用，见"收银台支付方式展示规则"页面。

## 我的部分交易会向买家询问额外信息，为什么只有部分？

某些支付方式在接受支付之前需要 Waffo 无法从订单中提供的信息——最常见的是经过验证的邮箱地址。当一笔支付路由到这类
支付方式时，收银台会收集该支付方式所需的信息，如果该支付方式要求验证，还会要求买家用发送到该地址的一次性验证码确认。

对你的对接有两个影响：

* 它是**按交易**变化的，因为它取决于路由到的支付方式，而不是你的账户或品牌。同一买家两笔相同金额的订单可能不同。
* 在创建订单时传一个可用的 `userInfo.userEmail` 可以减少输入：它可以预填该字段。对于某些支付方式，该地址对该笔支付是固定的，
  买家不能替换。

该步骤的机制——验证码有效期、已验证窗口、长度限制——见"收银台表单、预填与错误处理"页面。

## 你们报表里显示的 USD 金额和我算出来的不一致，为什么？

因为报表中的 USD 数字不是按交易当时的汇率换算的，也不是按我们报价的汇率换算的。换算依据是：

```
TPV (USD) = Σ [ order amount / market closing rate on the day the
                transaction succeeded, in Waffo's reporting time zone ]
```

公式中的三个要素几乎能解释所有差异：

| 要素 | 详情 |
| - | - |
| **汇率** | 当日的**市场收盘汇率**——不是盘中汇率，也不是应用于该笔支付本身的汇率 |
| **日期** | 交易**成功**的那一天，按 Waffo 的报表时区——不是你的本地日历日，也不是订单创建的日期 |
| **按交易** | 每笔交易按各自的日期换算，然后求和。一个时段的合计不是该时段金额按单一汇率的换算 |

兜底：当相关日期不是交易日，或无法获取汇率时，改用最近一个可用的收盘汇率。

所以一个月的报表合计通常会与"本地币种总额 × 我今天查到的汇率"不同，而两个数字都可能是对的。如果数字必须一致，
请按交易逐笔、按成功日期对账。

## 报表交易量统计哪些交易？

只统计达到**成功**状态的交易，按成功发生的那一天换算。一笔在某个时段创建、在下一时段成功的交易，计入成功的那个时段——
这是月末边界合计与你自己基于订单创建时间的统计不一致的第二个常见原因。

## 报表中的 USD 金额和买家实际支付的、或我收到的结算款是一回事吗？

不是——请把它们当作用途不同的三个数字：

| 数字 | 是什么 |
| - | - |
| 报表 USD 金额 | 按上述依据对订单金额做的报表换算。用于跨币种比较交易量 |
| 买家支付的金额 | 以买家支付币种计、按应用于该笔支付的汇率换算的金额。显示在收银台页面和收据上 |
| 你收到的结算款 | 由你的结算币种和周期决定。见结算文档 |

只有第二个是按该汇率实际流动的资金。第一个是一种度量。

## 我在哪里能看到按品牌的数据？

交易和报表数据都带有 SubMID，所以你可以在 Portal 和导出中区分业务线，而不必拆分账户。报表主题、交付和订阅选项由报表文档覆盖。

***

正在规划多品牌配置，或者看到对不上的报表数字？
请[联系支持](mailto:support@waffo.com)——如涉及对账，请附上你用于比对的订单 ID 和成功日期。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.