> ## 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 がホストするチェックアウト画面が、支払いの前・最中・後にどう振る舞うかを説明します。
決済手段の表示順やグループ化については、チェックアウト画面カスタマイズのドキュメントを参照してください。

## 注文が終了した後に顧客がチェックアウトリンクを再度開くと、どうなりますか？

注文が最終状態に到達した後も、一定期間 — プラットフォームで設定された日数で、注文完了時点から起算 — は、
リンクは実際の結果を表示します。

* 成功した注文は**成功ページ**を表示します — 注文の有効期間が過ぎたからといって、失敗として誤って表示されることはありません。
* 失敗した注文は**失敗ページ**を、該当するエラーコード（例：注文の期限切れ）とともに表示します。

この期間を過ぎるとリンクは照会できなくなり、代わりに専用の期限切れリンクページが表示されます。
処理中の注文は、処理中である限り照会可能です。

## チェックアウト画面が「処理中」のまま止まっています。支払いは失われたのですか？

必ずしもそうではありません。決済フローで即座に解決できないエラーが発生すると、チェックアウト画面は処理中の表示のまま、
その理由を表示します。裏側では、Waffo が注文を自動的にリトライし続けています。

リトライで結果が出るとすぐに、ページは自動的に成功ページまたは失敗ページへ進みます — 顧客に表示される内容は
完全にバックエンドの注文状態によって決まるため、顧客が再送信する必要はありません。最終状態は決済通知または
注文照会で確認してください。

## 支払い後、顧客は自社サイトにリダイレクトされますか？

注文作成時に何を渡したかによります。

| 注文作成時 | 結果ページの挙動 |
| - | - |
| リダイレクト URL を指定 | 顧客が結果ページで確認すると、指定した URL にリダイレクトされます。 |
| リダイレクト URL なし | 結果ページに **Close** ボタンが表示され、クリックするとチェックアウト画面が閉じます。 |

## チェックアウト画面と領収書には、どの加盟店名が表示されますか？

チェックアウト画面、支払い案内ページ、領収書に表示されるのは常に **Cashier Display Name**（加盟店 Portal で
設定する任意項目）のみです。KYB で登録した法人名（Merchant Name）が顧客に表示されることは**決して**ありません。

Cashier Display Name を設定していない場合、ページヘッダーの加盟店名の欄は単に非表示になります —
登録済みの会社名がフォールバックとして使われることはありません。

知っておくべき例外が 1 つあります。Merchant-of-Record の開示注記が表示されるページでは、Cashier Display Name が
未設定の場合、その注記は登録済みの法人名にフォールバックします。登録名をどこにも表示させたくない場合は、
Cashier Display Name を設定してください。

## 1 つの MID の下で、商品ラインごとに異なるロゴを表示できますか？

はい。加盟店 Portal で（MID または SubMID レベルで）複数のロゴをアップロードでき、各ロゴには一意のロゴ ID が
付与されます。注文作成時にロゴ ID を渡すことで、そのチェックアウトセッションに表示されるロゴを制御できます。

フォールバックのルール：

* パラメーターが省略された場合、または ID が無効か存在しない場合は、**デフォルトのロゴ**が表示されます。
* 最初にアップロードしたロゴが自動的にデフォルトになります。Portal でデフォルトを他のロゴに切り替えられます。
* ロゴを 1 つもアップロードしていない場合、加盟店ロゴは表示されません。

## 異通貨の注文では、金額はどのように表示されますか？

注文通貨と顧客の支払い通貨が異なる場合、チェックアウト画面は顧客の支払い金額を目立つように表示し、
あわせて換算の内訳 — 元の注文金額、為替レート、税額（あれば） — を表示します。

カード決済の場合、内訳は為替レートが確定できた時点で表示されます。複数の支払い通貨が候補になる場合は、
顧客がレートを確定できるだけのカード情報を入力した後に表示されます。

注文通貨と支払い通貨が同じ場合は換算がないため、内訳は表示されません。

高度なレイアウトオプション（どの通貨を主表示にするか、フォントサイズを個別に指定するかなど）は
加盟店ごとに有効化されます — 必要な場合は Waffo の担当者にお問い合わせください。

## リピーターの顧客は、毎回情報を入力しなければなりませんか？

いいえ。繰り返し入力を減らす仕組みが 2 つあります。

* **保存された情報** — 顧客が初めてフォームを入力する際、「情報を保存する」オプションがデフォルトでチェックされています。
  そのままにしておくと、次回の購入時に情報が自動的に呼び出されます。
* **加盟店が渡す事前入力** — 注文作成時にすでに指定した項目のうち、ユーザー編集可としてマークされたものは
  チェックアウトフォームに事前入力され、顧客は支払い前に確認・変更できます。

## チェックアウトにはどんなページ状態がありますか？テストの基準にしたいのです。

ページは完全に注文状態によって駆動されるため、インテグレーションテストで見ているのは実際には注文の遷移です。
顧客が到達しうる状態は以下のとおりです。

| ページ状態 | 顧客に表示されるもの | 意味 |
| - | - | - |
| 決済手段の選択 | グループ化・並び替えされた決済手段の一覧 | 注文がまだ決済手段に確定していない |
| 決済フォーム | カード項目、または決済手段が必要とする項目 | 決済手段が選択され、入力が必要 |
| リダイレクト中 | **Pay** と再確認アクションのある短い中間画面 | 顧客が決済手段側へ遷移する必要がある |
| サイレントフォームポスト | 処理中の表示 | Waffo が非表示フレームで決済手段へポストしており、顧客がすることはない |
| 支払い案内 | QR コード、支払いコード、または銀行口座情報と手順 | 顧客が別の場所で支払い、Waffo が待機する |
| 処理中 | スピナーと、理由（ある場合） | 決済手段の応答待ち、またはリトライ中 |
| 成功 | 結果ページ、または指定 URL への即時リダイレクト | 支払いが成功した |
| 失敗 | エラーコード付きの失敗ページ | 支払いが失敗し、リトライ不可 |
| 期限切れリンク | 「このリンクは期限切れです」 | リンクがもう有効なチェックアウトに解決しない |

このうち 2 つはテスト中によく人を驚かせます。**サイレントフォームポスト**は処理中と見た目がまったく同じで、
それが意図された挙動です — フレームは意図的に非表示になっています。また、**支払い案内**と**処理中**は
ページが注文をポーリングして自動的に進む保留状態なので、止まっているように見えるページは通常正しく動作しています。

サブスクリプションの注文では、上記のいずれよりも前にモード選択ステップから始まることがあります。

## 失敗後、顧客は同じチェックアウトで別の決済手段を選べますか？

はい。注文がリトライ可能な状態で終わる失敗であれば可能です。ページは**決済手段の選択**状態に戻り、
失敗の理由をエラーメッセージとして表示するため、顧客は同じ注文・同じリンクで別の決済手段を選んで支払えます —
新しい注文も新しいリンクも不要です。

最終的な失敗 — ハードデクライン、期限切れの注文、解決しなくなったリンク — の場合は、代わりに失敗ページへ遷移し、
顧客はお客様から新しい注文を受け取る必要があります。

失敗がリトライ可能かどうかはその失敗自体の性質なので、注文作成のレスポンスからは区別できません。
インテグレーションでは、最初の失敗通知を注文の終わりと見なさないでください。
[決済結果](/docs/ja/support/payment-results-faq) を参照してください。

## Waffo の結果ページを完全にスキップして、顧客を直接自社サイトに戻せますか？

はい。ただし注文パラメーターによってではありません。アカウントでバイパスが有効になっている場合、
成功または失敗に到達したチェックアウトは、Waffo の結果ページをまったく表示せずに `successRedirectUrl` または
`failedRedirectUrl` へ即座にリダイレクトします — 顧客は中間の確認ステップを一切見ません。

2 つの条件が両方とも成立する必要があるため、フォールバックを計画してください。

* アカウントでバイパスが有効になっている必要があります。`cashierAppearance` のキーも注文作成の項目も
  存在しません — Waffo サポートに有効化を依頼してください。
* 対応するリダイレクト URL が注文に設定されている必要があります。設定がなければ、バイパスの有無にかかわらず
  Waffo の結果ページが表示されます。

すべてのリダイレクトに当てはまる注意点はここにも当てはまり、間にページがないぶんより厳しく当てはまります。
指定 URL に到達したことは支払いの証明ではありません。履行の前に、通知または
`POST /api/v1/order/inquiry` から状態を読み取ってください。

## 期限切れのリンクと、改変されたリンクは同じエラーですか？

いいえ。異なり、その違いは顧客にも見えます。

| 何が起きたか | 顧客に表示されるもの |
| - | - |
| リンクは解決するが、その先のチェックアウトがもう有効ではない — すでに支払い済み、またはセッションが過ぎた | 専用の\*\*「このリンクは期限切れです」\*\*画面。支払いはすでに処理された、またはセッションが期限切れになったと表示される |
| リンクがまったく読み取れない — 途中で切れた URL、壊れたり編集された識別子、別の注文からコピーした URL | 汎用の\*\*「問題が発生しました」\*\*画面 |

ここから 2 つのことが導かれます。顧客が汎用画面を報告した場合、まずリンクの完全性を疑ってください —
多くの場合、URL が書き換えられた、メッセージングクライアントで切り詰められた、あるいは一部を落とす何かを
経由しています。これは自社アプリと WebView の間で URL を書き換える場合と同じ失敗パターンです。
また、新しいはずのリンクで期限切れ画面が表示される場合、その先の注文は最終状態に到達しています —
リンクを再発行するのではなく、注文を照会してください。

## 3-D セキュアはチェックアウト上で行われますか、それとも別のリダイレクトですか？

両方の部分が発生し、そのうち 1 つだけが見えます。

* **デバイスデータのステップ**は、支払いが送信される前、顧客がまだチェックアウト上にいる間に
  見えない形で実行されます。顧客には見えず、お客様が実装するものもありません。
* **チャレンジ**は、必要な場合にカード発行会社によって提示されます。発行会社の認証ページへの追加ステップであり、
  その後顧客はチェックアウトに戻ってフローが続きます。

チャレンジが発生するかどうかは、その取引に対する発行会社の判断なので、顧客に単一画面でのカード決済を
約束することはできません。Waffo のフロントエンド SDK で独自のカードページを構築する場合は、チャレンジの提示方法を
ある程度制御できます —
[Google Pay と SDK の 3DS フロー制御](/docs/ja/developer-docs/integration/elements/frontend-integration#3ds-flow-control)
を参照してください。チャレンジがタイムアウトした場合の挙動については
[決済のタイムアウトと確定性](/docs/ja/support/payment-timeout-and-finality-faq#3ds-authentication-timed-out-can-i-retry-on-the-same-order)
を参照してください。


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