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

# 1つのアカウントで複数ブランドを運営する

> SubMID を使って 1 つの Waffo アカウントで複数のブランドや事業ラインを運営する方法——ブランドごとのチェックアウト表示名とロゴ、どのレベルの設定が優先されるか、何も設定していない段階で何が起きるか、何が固定されるか、一部の決済で追加収集される情報、そしてレポート内の USD 金額がどのように換算されるか。

このページは、複数のブランド、店舗、または事業ラインで販売しているアカウント向けです。
ページ単位のスタイル設定については「チェックアウト画面のカスタマイズ」ドキュメントで
説明しています。このページでは、それらの設定をブランドごとに異なるものにするための
アカウント構造について説明します。

## 複数のブランドを持っています。ブランドごとに別々の Waffo アカウントが必要ですか？

いいえ。加盟店タイプを変更する必要もありません。サポートされている構造は、既存の MID を
そのまま維持し、**ブランドまたは事業ラインごとに SubMID** を追加することです。各 SubMID は
独自の顧客向けアイデンティティを持つことができ、アカウント、契約、レポートは 1 か所に
まとまったままです。

SubMID で設定できるもの：

| SubMID ごと | 効果 |
| - | - |
| チェックアウト表示名 | 購入者がチェックアウト画面と領収書で目にする名前 |
| 加盟店ロゴ | MID とは別にアップロードされる、独自のロゴ一覧 |
| チェックアウトのスタイル | 独自の配色とサイズ、または MID からの継承 |
| 決済手段の表示順 | 国ごとの独自の並び順 |
| 注文の作成 | 注文は MID に対しても SubMID に対しても作成できます |

## SubMID の注文では、チェックアウト画面にどの名前とロゴが表示されますか？

優先度の高いものから順に解決されます：

| 優先度 | ソース |
| - | - |
| 1 | 注文で送信した値——`brandInfo.cashierDisplayName`（最大 128 文字）と `brandInfo.cashierLogoUrl`（最大 512 文字） |
| 2 | **SubMID** に設定された値 |
| 3 | **MID** に設定された値 |

つまり MID はフォールバックのアイデンティティとして機能します。何も設定されていない SubMID
は、何も表示しないのではなく、MID の名前とロゴを表示します。どちらのレベルにも表示名が
設定されていない場合、加盟店名の欄は単に非表示になります——KYB で登録した法人名が
代わりに表示されることはありません。

注文レベルの 2 つのフィールドはいずれもセッション単位で、保存されている設定は一切変更しません。
ブランドが事業ラインではなく個々の取引の属性である場合に適したツールです。

## MID は常にフォールバックのアイデンティティとして機能しますか？

標準的な加盟店アカウントでは、はい：独自の表示名を持たない SubMID の注文には MID の表示名が
表示されます。例外が 1 つあります——\*\*機関加盟店（institutional merchant）\*\*として設定された
アカウントでは、表示名は **SubMID のみ**から解決されます。その SubMID に表示名が設定されて
いない場合、アカウントレベルにフォールバックせず、加盟店名の欄は非表示になります。

自社アカウントにどちらが適用されるか不明な場合は、設定のない SubMID がテスト用チェックアウト
画面でアカウントレベルの名前を表示するかどうかを確認してください。

## ブランドは事業ラインではなく取引ごとに変わります。それでも SubMID は必要ですか？

必ずしも必要ではありません。決定要因が継続的な事業ラインではなく個々の注文であれば、
代わりに注文でアイデンティティを送信してください：

| フィールド | 上限 | 備考 |
| - | - | - |
| `brandInfo.cashierDisplayName` | 128 文字 | そのセッションについて、設定済みの表示名を上書きします |
| `brandInfo.cashierLogoUrl` | 512 文字 | 画像 URL（`http://`/`https://`）または事前作成したロゴ ID（`logo_…`）のどちらかを受け付けます |

どちらかのフィールドに無効な値があった場合、その値は**エラーなく破棄され**、注文はそのまま
作成されます——設定済みのアイデンティティで表示され、差異を説明するエラーは返されません。
送信する値は事前に検証してください。

ロゴ ID の形式、および ID が MID ごと・SubMID ごとにどのように割り当てられるかについては、
「チェックアウト画面のカスタマイズ」ドキュメントで説明しています。

差異が継続的なもの（ブランド、店舗、独自の見た目と独自のレポート区分を持つ事業ライン）であれば
SubMID を使い、取引ごとに異なるものであれば注文フィールドを使ってください。

## 最初の SubMID を追加しようとしています。既存のトラフィックに何か変化はありますか？

いいえ。SubMID レベルで何かを設定するまで、すべては引き続き既存の MID 設定に解決されます——
同じチェックアウト表示名、同じロゴ、同じスタイル、同じ表示順です。SubMID の追加そのものは
顧客に見える変更ではなく、それを設定することが変更になります。

Portal では各 SubMID がその状態とともに一覧表示されるため、何が MID から分岐しているかを
一目で確認できます：

| タグ | 意味 |
| - | - |
| **Using MID config** | このレベルではまだ何も設定されていません |
| **Customized** | この SubMID は独自のロゴまたはスタイルを持っています |

カスタマイズ済みの SubMID で **Reset** を実行すると、Using MID config に戻ります。

## SubMID を使い始めると、何が固定されますか？

構造です。SubMID が初期オンボーディング手順を完了するか、本番取引を処理すると、その構成は
**ロックされ、元に戻せなくなります**——その後にその SubMID を MID に巻き戻すことはできません。

計画への影響：ブランドと SubMID の対応関係は、本番稼働の後ではなく前に決めてください。
後から SubMID を追加することは問題ありませんが、既存の SubMID を統合することはできません。

## ブランドごとに異なる決済手段のセットと異なる並び順を設定できますか？

並び順は、はい——決済手段の表示順は国ごとに設定され、MID とは独立して SubMID ごとに設定できます。
どの決済手段が存在するかは SubMID 構造ではなく契約によって決まるため、SubMID によって
アカウントが持っていない決済手段を利用可能にすることはできません。

表示順、グループ化、利用可否がどのように相互作用するかについては、「チェックアウト決済手段の
表示ルール」ページを参照してください。

## 一部の取引で購入者に追加情報の入力を求めています。なぜ一部だけなのですか？

一部の決済手段は、決済を受け付ける前に、Waffo が注文から補うことのできない情報——最も一般的
なのは確認済みのメールアドレス——を必要とします。決済がそのような決済手段にルーティングされると、
チェックアウト画面はその決済手段が必要とする情報を収集し、確認が必要な決済手段の場合は、
そのアドレスに送信されるワンタイムコードでの確認も購入者に求めます。

連携への影響は 2 点です：

* これは**取引ごと**に異なります。アカウントやブランドではなく、ルーティングされた決済手段に
  従うためです。同じ購入者からの同額の 2 つの注文でも異なる場合があります。
* 注文作成時に有効な `userInfo.userEmail` を送信すると、入力の手間が減ります：フィールドに
  事前入力できます。一部の決済手段では、アドレスはその決済に対して固定され、購入者が
  差し替えることはできません。

このステップの仕組み——コードの有効期間、確認済み状態の有効期間、文字数制限——は
「チェックアウトのフォーム、事前入力とエラー処理」ページにあります。

## レポートに表示される USD 金額が、自分で計算した値と一致しません。なぜですか？

レポートの USD 数値は、取引時点のレートでも、当社が提示したレートでも換算されていないためです。
換算の基準は次のとおりです：

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

この式の 3 つの要素が、ほとんどすべての差異を説明します：

| 要素 | 詳細 |
| - | - |
| **レート** | その日の**市場終値レート**——日中レートではなく、決済そのものに適用されたレートでもありません |
| **日** | Waffo のレポート用タイムゾーンで取引が**成功**した日——お客様の現地の暦日ではなく、注文が作成された日でもありません |
| **取引ごと** | 各取引はそれぞれの日で換算され、その後合計されます。期間の合計は、期間の金額を単一のレートで換算したものではありません |

フォールバック：該当日が取引日でない場合、またはレートを取得できない場合は、直近で利用可能な
終値レートが代わりに使用されます。

したがって、月次レポートの合計は通常「現地通貨の合計 × 今日調べたレート」とは異なり、
どちらの数値も正しいということがあり得ます。数値を一致させる必要がある場合は、成功日に
基づいて取引ごとに照合してください。

## レポートの取引量には、どの取引がカウントされますか？

**成功**状態に達した取引のみが、その成功が発生した日で換算されてカウントされます。ある期間に
作成され、次の期間に成功した取引は、成功した期間にカウントされます——これが、月の境目の合計が
お客様側の注文作成日ベースの集計と一致しない、2 つ目のよくある理由です。

## レポートの USD 金額は、購入者が支払った金額や自分に精算される金額と同じですか？

いいえ——目的の異なる 3 つの別々の数値として扱ってください：

| 数値 | 内容 |
| - | - |
| レポートの USD 金額 | 上記の基準による、注文金額のレポート用換算。通貨をまたいだ取引量の比較用 |
| 購入者が支払った金額 | 購入者の決済通貨での金額で、その決済に適用されたレートによるもの。チェックアウト画面と領収書に表示されます |
| 精算される金額 | 精算通貨と精算サイクルによって決まります。精算のドキュメントを参照してください |

そのレートで実際に資金が動いたのは 2 つ目のみです。1 つ目は計測値です。

## ブランドごとの数値はどこで確認できますか？

取引データとレポートデータには SubMID が含まれているため、アカウントを分けることなく、Portal と
エクスポートで事業ラインを区別できます。レポートの種類、配信、配信登録のオプションについては
レポートのドキュメントで説明しています。

***

複数ブランド構成を計画中ですか、それとも照合できないレポート数値がありますか？
[サポートにお問い合わせください](mailto:support@waffo.com)——照合の場合は、比較対象としている
注文 ID と成功日を含めてください。


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