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

# チェックアウト画面における決済手段の表示ルール

> Waffo のチェックアウト画面がどの決済手段をどの順番で表示するかを決める仕組み：加盟店が定義する並び順、新規契約した決済手段、折りたたみ表示、利用不可の決済手段、国別のグループ化、および表示モードのオプション。

このページでは、Waffo のチェックアウト画面がユーザーに表示する決済手段、そのグループ化、
および表示順を決定するために用いているルールを説明します。

## 決済手段の表示順は自分で制御できますか？

はい。加盟店 Portal で **Cashier Customization → Cashier Ranking** に進みます。
そこでは次の操作ができます。

* **国ごとに**、MID または SubMID のレベルで並び順を設定する。
* 決済手段（および決済種別内のサブ決済手段）を**ドラッグ＆ドロップ**で並べ替える、
  または**ピン**操作で項目を先頭に移動する。
* 保存する前に、結果のチェックアウト画面レイアウトをリアルタイムでプレビューする。
* **Reset to Default Setting** をクリックして、選択した国のカスタマイズを削除し、
  プラットフォームのデフォルト並び順に戻す。

一覧には、有効な契約のもとで利用可能な決済手段のみが含まれます。
国を一度もカスタマイズしていない場合は、プラットフォームのデフォルト並び順が適用されます。

## 新しく契約した決済手段はどこに表示されますか？

すでに並び順をカスタマイズしている場合、新しく有効化された決済手段が
既存の順序を乱すことはありません。

* 設定済みの項目は、その位置を正確に保持します。
* 新しい決済手段は、プラットフォームのデフォルトの相対順で、一覧の**末尾に追加**されます。
* 新しいサブ決済手段（たとえば eWallet 配下の新しいウォレット）は、
  自身の決済種別グループの末尾に追加されます。

並び順ページには「新規」を示す視覚的なマークがないため、新しく契約した決済手段は
そのグループの最下部にひっそりと表示されます。順序が重要な場合は、新しい決済手段を
契約した後に並び順ページを確認してください。デフォルト設定のままの場合は、
新しい決済手段がデフォルトの位置に入った状態で一覧が更新されるだけです。

## 一部のウォレットが「See more」をクリックしないと表示されないのはなぜですか？

ある決済種別に 4 つ以上のサブ決済手段が含まれる場合、チェックアウト画面は
（並び順に基づき）先頭の 3 つを表示し、残りを **See more (X more)** ボタンの背後に
折りたたみます。クリックすると全一覧が即座に展開され、**Show less** で再び折りたたまれます。
これによりページがコンパクトに保たれ、上位に並べた決済手段が目立つようになります。
Portal のライブプレビューでも同じ折りたたみが適用されます。

## チェックアウト画面で決済手段がグレーアウトしているのはなぜですか？

決済手段が一時的に利用できない場合（たとえばチャネルやプロバイダーのメンテナンス中）、
チェックアウト画面は**非表示にするのではなくグレーアウト**します。

* グレーアウトは設定済みの並び順を変更しないため、レイアウトは安定したままです。
* ある決済種別配下のすべてのサブ決済手段が利用できない場合、その種別のアイコン全体が
  グレーアウトされ、選択できなくなります。
* デフォルトの選択は、自動的に最初の*利用可能な*決済手段に移ります。

メンテナンスが終了すると、利用可否は自動的に回復します。

## 国のタブはどのように整理されていますか？想定外の国の下にウォレットが表示されるのはなぜですか？

チェックアウト画面のタブは、**Payment Method Country**（決済手段の国）——決済手段そのものが
属する国——によって決済手段をグループ化します（ローカルウォレットは本国に属し、
カードブランドは Global です）。このマッピングはプラットフォームによって定義され、
加盟店ごとに変更することはできません。

* グローバルに対応している決済手段は、本国のタブと **Global** タブの両方に表示されます。
* タブセレクターは、注文が 2 つ以上のタブに解決される場合にのみ表示されます。
* デフォルトのタブはユーザーの IP から推定されます。一致するタブがない場合は Global タブが
  選択され、最終的なフォールバックとしてアルファベット順が用いられます。

## 特定の注文でユーザーに表示する内容を絞り込めますか？

部分的に可能ですが、その正確な動作は多くの方の予想と異なります。

注文作成時に任意項目の `payMethodCountry` を渡すと、チェックアウト画面は他国に属する
**ローカル**決済手段を非表示にします。**グローバルに利用可能な決済手段——カードブランドなど——は
常に残ります**。特定の国に紐づいていないためです。したがって `payMethodCountry=IDN` を渡しても、
ページがインドネシアの決済手段だけに絞られるわけではなく、グローバルな決済手段は引き続き
表示されます。これは想定された動作であり、バグではありません。

知っておくべき効果がさらに 2 つあります。

* 渡した国にローカル決済手段が少なくとも 1 つある場合、チェックアウト画面は国のタブの表示を
  やめ、単一の一覧を提示します。
* その国にローカル決済手段が 1 つもない場合、決済手段はそれぞれの国のグループ化を維持するため、
  タブが引き続き表示されることがあります。

契約済みの決済手段がフィルターをすべて通過できない場合、空のページを表示するのではなく、
注文作成が拒否されます。

この項目を省略すると、チェックアウト画面は契約のもとにあるすべての決済手段を、
上記のとおりタブにグループ化して表示します。

## 国のタブを削除したり、あるウォレットをグループから独立させたりできますか？

特定のレイアウト要件を持つ加盟店向けに、追加の表示オプションが 2 つあります。

* **フラット表示** — 国をまたぐすべての決済手段を、国のタブなしで単一ページに表示します。
  フラット化した一覧が長すぎる場合、チェックアウト画面はその注文について自動的に
  国別グループ化にフォールバックします。
* **スタンドアロン表示** — 単一の決済手段をその決済種別グループから切り出し、
  独立したトップレベル項目として並べます（カード種別は切り出せません）。

どちらもデフォルトではオフです。いずれかの表示形式をアカウントで有効にしたい場合は、
Waffo のアカウントマネージャーにご連絡ください。

## このウォレットはチェックアウト URL しか返しませんでした——ユーザーはチェックアウト画面で何をするのですか？

すべての決済手段にディープリンクがあるわけではありません。東南アジアのウォレットや
QR コード決済手段のいくつかは **Waffo のチェックアウト URL** を返し、
実際に決済を承認するステップはそのページ上で行われます。

* **QR コード決済手段**は、Waffo のチェックアウト画面に QR コードを表示します。
  ユーザーは自身の銀行アプリまたはウォレットアプリでそれを読み取ります。
* **一部のウォレット**は、まずチェックアウト画面でユーザーの電話番号を収集します。
  ユーザーが送信すると、ウォレットアプリがそのユーザーの電話に承認リクエストをプッシュし、
  ユーザーはそこで承認します。

連携上の影響が 2 つあります。

* アプリと WebView がチェックアウト画面を開けなければなりません——ディープリンクしか
  処理しない場合、これらの決済手段は行き止まりになります。
* ユーザーが **QR コードを読み取り、保存、またはコピー**できる必要があるため、
  長押しやスクリーンショットをブロックするコンテナ内でチェックアウト画面を表示しないでください。

どの URL 項目を読むべきか（`orderAction.actionType` によって決まる `webUrl` と `deeplinkUrl` の使い分け）は、
[連携 FAQ](/docs/ja/developer-docs/tools-and-references/references/faq) で説明しています。

## 想定していた決済手段がチェックアウト画面にまったく表示されません。原因はどう調べればよいですか？

表示されないことは、グレーアウトとは異なります。グレーアウトは一時的に利用不可という
意味です——上記を参照してください。表示されないとは、その注文の一覧にその決済手段が
一度も入らなかったことを意味します。次の一覧を順番に確認してください。
各ステップはご自身で確認できるものです。

| 確認事項 | 方法 |
| - | - |
| その決済手段は**この環境で**契約のもと有効になっていますか？ | `POST /api/v1/paymethodconfig/inquiry` — サンドボックスと本番環境は別々に回答します |
| 注文の通貨に対応していますか？ | 同じレスポンスに決済手段ごとの通貨が一覧されます |
| 注文金額はその決済手段が受け付ける範囲内ですか？ | 同じレスポンスに金額範囲が含まれます——注文を作成する前に確認してください |
| ご自身でフィルターしていませんか？ | 注文の `payMethodType` / `payMethodName` / `payMethodCountry` が一覧を絞り込みます |
| 送信した端末に対応していますか？ | `userInfo.userTerminal` に対応していない決済手段は提示されません |
| 折りたたまれていませんか？ | ある種別に 4 つ以上のサブ決済手段があると、残りは **See more** の背後に置かれます |

最も多くの方がつまずくのは、金額範囲と環境の 2 つです。決済手段の範囲をわずかに外れた金額は、
エラーを出すのではなくその決済手段を静かに一覧から除外します。また、本番環境で稼働している
決済手段が、テスト環境でも必ず有効になっているとは限りません。

各確認の仕組みは
[決済手段の設定と上限](/docs/ja/support/payment-method-config-and-limits-faq) にあります。
6 つの確認をすべて通過してもなお決済手段が表示されない場合は、注文 ID、金額、通貨、
送信した端末を添えて[サポートにお問い合わせください](mailto:support@waffo.com)。

## すべての決済で必ずリダイレクトが発生しますか？そのステップを省くことはできますか？

いいえ、どちらもできません。遷移の回数は決済手段の特性であり、チェックアウト画面が
追加しているものでも、設定で取り除けるものでもありません。

| 決済手段の挙動 | 顧客から見える遷移 |
| - | - |
| カード | チェックアウト画面にとどまります。カード発行会社が認証ステップを挿入することがあります |
| QR コード | チェックアウト画面にとどまります——コードはそこに表示され、顧客は別のアプリで読み取ります |
| コードおよび銀行口座情報 | チェックアウト画面にとどまります——情報はそこに表示され、顧客は別の場所で支払います |
| 自身の画面で承認するウォレット | ウォレットへ 1 回遷移し、その後戻ります |
| 顧客の電話に承認をプッシュするウォレット | 遷移なし——チェックアウト画面が識別子を収集して待機します |

つまりリダイレクトは、決済手段が Waffo の管理外の場所での顧客の承認を必要とする場合にのみ
存在します。これを取り除く設定はなく、独自のページを構築しても取り除けません——チェックアウト画面が
代わりに行っていたリダイレクトを、ご自身で受け取ることになるだけです。

取り除く*ことができる*のは、Waffo 自身の選択ページです。注文で決済手段を固定すると、
顧客はその決済手段のフローに直接入ります。また、アカウントでバイパスが有効になっていれば、
最後の Waffo の結果ページも取り除けます——
[チェックアウト画面のライフサイクル](/docs/ja/support/cashier-order-lifecycle-faq) を参照してください。

## 金額の内訳には何が表示されますか？価格と税を別々に表示できますか？

すでに別々に表示されています。注文が該当する値を持っている場合、チェックアウト画面は
合計 1 行だけではなく、金額を項目ごとに表示します。

| 行 | 表示される場合 |
| - | - |
| Price | 割引適用前の注文金額 |
| Discount | 注文にプロモーションコードまたはクーポンが適用されている |
| Subtotal | 通貨をまたぐ注文で、注文金額 → 顧客金額として表示され、その下に為替レートが示されます |
| Customer fee | 注文に顧客負担の手数料が含まれている |
| Tax | 注文が課税対象である。この行には該当する税の固有名称がラベルとして付くため、顧客は「tax」という語ではなく現地の用語を目にします |
| Total | 常に |

知っておくべき挙動が 2 つあります。

* 顧客が住所を入力するまで税を計算できない場合、税の行は住所入力を促すメッセージとともに
  表示され、入力後に確定します——そのため顧客は、確定する前に必ず税が存在することを認識できます。
* サブスクリプションでは、合計行は本日支払うべき金額として表示されます。トライアルや
  開始遅延がある場合、これは継続課金額とは異なります。

表示を主導する通貨や金額のフォントサイズはカスタマイズ対象の一部です——
[チェックアウト画面のカスタマイズ](/docs/ja/support/cashier-customization-faq) を参照してください。

## 決済手段のアイコンやブランド名を変更したり、独自のテキストやリンクを追加できますか？

いいえ。カスタマイズ対象はご自身のブランディング——ロゴ、加盟店名、色、角丸、基本フォントサイズ、
ヘッダーレイアウト、金額表示——に限られ、それ以外は含まれません。具体的には、
次の項目を制御する手段はありません。

* 決済手段のアイコンやブランド名。これらは顧客が決済手段を認識できるように
  プラットフォームが提供する素材から描画され、Portal からダウンロードすることもできません。
  ご自身のページにブランドのマークが必要な場合は、そのブランド自身のブランドガイドラインから
  取得してください。使用ルールもそこに記載されています。
* ページ上のどこかに配置する独自のフリーテキスト。
* 独自のリンク——決済ガイド、ヘルプセンター、利用規約へのリンクなど。

チェックアウト画面で決済手段の隣に加盟店作成の文言やリンクが必要な場合、その手段は設定ではなく
加盟店構築のページです——
[独自のチェックアウト画面を構築する](/docs/ja/support/merchant-built-checkout-faq) を参照してください。

設定*可能な*項目の全一覧は
[チェックアウト画面のカスタマイズ](/docs/ja/support/cashier-customization-faq) にあります。

## デフォルトの並び順は、私の市場向けの推奨ですか？

それは**プラットフォームのデフォルト**——国をカスタマイズしていない場合に適用される順序です。
お客様のトラフィックから導出されたものでも、加盟店ごとに調整されたものでも、
お客様の市場についての助言でもありません。変更をためらうべき推奨ではなく、
妥当な出発点として扱ってください。

並び順が商業的に重要である場合、有効な手段は、重視する国をカスタマイズし、
コンバージョンをご自身で比較することです。並び順ページは国ごとなので、
他の市場に影響を与えずに 1 つの市場を変更できます。特定の市場でどの決済手段を先頭に
すべきかについては、デフォルトの順序から意図を推測するのではなく、
Waffo の担当者にお尋ねください。

## 国の切り替えボタンが見つけにくいです。顧客を正しい一覧に導くにはどうすればよいですか？

顧客がそれを見つけることに頼らないでください。問題を軽減する方法が 2 つあり、
1 つ目のほうが 2 つ目よりはるかに効果的です。

* **注文で国を固定する。** 顧客の所在地がわかっている場合——アカウント、配送先住所、
  利用中のストアフロントなどから——`/api/v1/order/create` で `payMethodCountry` を渡します。
  すると、チェックアウト画面は探すべきタブのない単一の一覧を提示し、カードブランドなどの
  グローバル決済手段は引き続き利用可能なままです。これは、顧客が VPN や社内ネットワークを
  使用していて IP が誤った国に解決されるケースも解消します。
* **決済手段を固定する。** ご自身のページで既にどの決済手段を使うか尋ねている場合、
  `payMethodType` と `payMethodName` を渡すと、顧客は選択ページを完全にスキップします。

`payMethodCountry` が何をフィルターし、何をフィルターしないかを含むパラメーターの挙動は、
上の質問と
[チェックアウトのカスタマイズ](/docs/ja/developer-docs/integration/checkout/customization#when-to-pass-paymethodcountry) にあります。

## 現地通貨で価格を設定した場合でも、顧客はカードで支払えますか？

国のタブは注文通貨ではなく**決済手段の**国でグループ化されるため、現地通貨で価格を設定しても
カード決済手段が除外されることはありません。カードブランドはグローバルです。Global タブの下にあり、
顧客がどのローカルタブを開いてもそこに残ります。ローカルタブに切り替えた顧客が見ているのは
その国のローカル決済手段です——カードは消えたのではなく、隣のタブにあります。

カード決済手段を本当に利用不可にし得るのは、その通貨自体がカード契約で有効になっていないことです。
これは注文を作成する前に確認できます。各決済手段が受け付ける通貨は
`paymethodconfig/inquiry` のレスポンスに一覧されています——
[決済手段の設定と上限](/docs/ja/support/payment-method-config-and-limits-faq) を参照してください。


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