> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# チェックアウトフロー

> 顧客が購入を完了する方法

## チェックアウト概要

Waffo Pancake チェックアウトは、顧客にシームレスでコンバージョン最適化された支払い体験を提供します。

## 2つのチェックアウト方法

Waffo Pancake は2つのチェックアウト方法をサポートしています — ユースケースに合わせて選択してください：

<CardGroup cols={2}>
  <Card title="商品購入リンク" icon="link">
    **永続リンク** — 期限切れなし、商品を更新しても有効。

    * 最適：ウェブサイト、SNS、メールでの共有
    * コード不要
  </Card>

  <Card title="チェックアウトセッション（API）" icon="code">
    **動的リンク** — API 経由でカスタムパラメータ付きで作成。

    * 最適：カスタムチェックアウトフロー、動的価格設定、メタデータ
    * デフォルト 45 分の有効期限（expiresInSeconds パラメータで最大 7 日間まで設定可能）
  </Card>
</CardGroup>

### 商品購入リンク

すべての商品に永続的な購入リンクがあります：

```
https://checkout.waffo.ai/{store-slug}/{product-slug}
```

テストモード：

```
https://checkout.waffo.ai/{store-slug}/{product-slug}/test
```

顧客がリンクを開くと、チェックアウトセッションが自動的に作成されます。ダッシュボードで「リンクをコピー」をクリックするだけです。

### チェックアウトセッション（API）

高度なユースケースには、API 経由でチェックアウトセッションを作成します：

```bash theme={"system"}
POST /v1/actions/checkout/create-session
```

### 認証済み vs 匿名チェックアウト

API 経由でセッションを作成する際、2つのモードを選択できます：

* **認証済み**：`buyerIdentity` を提供して注文を安定した識別子に紐付け。チェックアウトフォームを事前入力し、購入後のセルフサービスを有効化。
* **匿名**：ID 不要。購入者が詳細を手動入力。共有リンクやテンプレートストアに適しています。

<Warning>
  購入者を把握している場合は、認証済みチェックアウトを強く推奨します。詳細は [SDK チェックアウトモード](/ja/integrate/sdks#チェックアウトモード) を参照。
</Warning>

<Note>
  チェックアウトセッションはサーバーサイドで生成され、作成時に商品バージョンと価格がロックされます。
</Note>

## チェックアウトフロー

<Steps>
  <Step title="消費者情報" icon="user">
    メールアドレス、国、請求情報を収集。税計算と注文処理に使用。
  </Step>

  <Step title="決済" icon="credit-card">
    カード情報を入力、または Apple Pay / Google Pay で決済を完了。
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/waffo/fAGQ8sa2qycWEk2d/images/checkout/checkout-step1.png?fit=max&auto=format&n=fAGQ8sa2qycWEk2d&q=85&s=e7454a2c64f08d42fe0fa1ac4084b712" alt="チェックアウトページ — 消費者情報" width="1440" height="900" data-path="images/checkout/checkout-step1.png" />
</Frame>

## チェックアウトページ要素

### ヘッダー

* ストアロゴ
* ストア名
* セキュアチェックアウト表示

### プロダクトセクション

| 要素      | 説明         |
| ------- | ---------- |
| プロダクト画像 | ビジュアル表示    |
| プロダクト名  | アイテムタイトル   |
| 説明      | 短いプロダクト詳細  |
| 価格      | 金額と通貨      |
| 数量      | 対応プロダクトの数量 |

### 支払いセクション

| 要素       | 説明        |
| -------- | --------- |
| メールフィールド | 顧客連絡先     |
| カード番号    | 支払いカード入力  |
| 有効期限     | カード有効期限   |
| CVC      | セキュリティコード |
| 請求先住所    | 税計算用      |

### 注文サマリー

| 要素 | 説明        |
| -- | --------- |
| 小計 | プロダクト価格   |
| 税金 | 地域に基づいて計算 |
| 合計 | 最終請求金額    |

## サブスクリプションチェックアウト

サブスクリプション商品では、追加要素が表示されます：

<CardGroup cols={2}>
  <Card title="請求プレビュー" icon="calendar">
    * 初回請求日
    * 周期的金額
    * 請求頻度
    * 次回請求日
  </Card>

  <Card title="試用情報" icon="flask">
    * 試用期間
    * 試用終了日
    * 試用後の初回請求
    * いつでもキャンセル可能の説明
  </Card>
</CardGroup>

## 税金処理

Waffo Pancake は税金を自動計算：

### 税金表示

| 設定 | 動作            |
| -- | ------------- |
| 外税 | 税金を別途表示、価格に加算 |
| 内税 | 価格に税金込み、内訳を表示 |

### 税種類

* **売上税**（米国）
* **VAT 付加価値税**（欧州）
* **GST 商品・サービス税**（オーストラリア、カナダ）

<Note>
  税率は顧客の請求先住所に基づいて決定されます。プロダクトに正しい税カテゴリが設定されていることを確認してください。
</Note>

## 支払い方法

### クレジット/デビットカード

対応カードネットワーク：

* Visa
* Mastercard

カード検証には以下が含まれます：

* Luhnアルゴリズムチェック
* 有効期限検証
* CVC検証
* 3Dセキュア（必要な場合）

### デジタルウォレット

<CardGroup cols={2}>
  <Card title="Apple Pay" icon="apple">
    利用可能：

    * MacのSafari
    * iOSデバイス
    * Touch ID / Face ID認証
  </Card>

  <Card title="Google Pay" icon="google">
    利用可能：

    * Chromeブラウザ
    * Androidデバイス
    * Googleアカウントに紐づけられたカード
  </Card>
</CardGroup>

## エラー処理

### 一般的な支払いエラー

| エラー     | 原因            | 顧客アクション   |
| ------- | ------------- | --------- |
| カード拒否   | 残高不足または銀行ブロック | 別のカードを試す  |
| 無効なカード  | カード番号が間違い     | 確認して再入力   |
| 期限切れカード | カードが期限切れ      | 有効なカードを使用 |
| CVC不一致  | セキュリティコードが間違い | CVCを再入力   |
| 3DS失敗   | 銀行認証失敗        | 銀行に連絡     |

### エラーメッセージ

エラーメッセージの特徴：

* 明確で行動可能
* 技術的でない言葉
* 役立つ次のステップ
* 機密データを露出しない

## チェックアウト後

### 成功ページ

* お礼のメッセージ
* 注文確認番号
* 次のステップ
* サポート連絡先

### 確認メール

自動送信、内容：

* 注文詳細
* 支払い領収書
* プロダクトアクセス情報
* カスタマーポータルリンク

### リダイレクトオプション

チェックアウト後の顧客の行き先を設定：

* デフォルト成功ページ
* カスタムサンキューページURL
* プロダクト配信ページ
* 会員エリア

## チェックアウトのテスト

テストモードを使ってチェックアウトを試す：

### テストカード番号

| タイプ              | カード番号                 | 結果 |
| ---------------- | --------------------- | -- |
| Visa クレジット       | `4576 7500 0000 0110` | 成功 |
| Mastercard クレジット | `2226 9000 0000 0110` | 成功 |
| Visa デビット        | `4001 7000 0000 0110` | 成功 |
| Mastercard デビット  | `2226 9300 0000 0110` | 成功 |
| Visa クレジット       | `4576 7500 0000 0220` | 拒否 |
| Mastercard クレジット | `2226 9000 0000 0220` | 拒否 |

任意の将来の有効期限、任意の3桁のCVC。

<Tip>
  公開前に必ずチェックアウトフローをテストしてください。確認メールを含め、エンドツーエンドで顧客体験を検証してください。
</Tip>

***

## チェックアウトステータス

### 処理ページ

支払い処理中、顧客に表示：

* アニメーション読み込みインジケーター
* 「支払いを処理中」メッセージ
* 予想待ち時間

### 成功ページ

支払い成功時：

* 注文確認番号
* 領収書メール確認
* 次のステップまたはアクセス手順
* カスタマーポータルリンク

### 失敗ページ

支払い失敗時：

* 明確なエラー説明
* 推奨アクション（別のカードを試すなど）
* リトライボタン
* サポート連絡オプション

***

## チェックアウトセキュリティ

### 商品購入リンク

* リンクは永続的かつ公開 — 機密データは埋め込まれていません
* 顧客がリンクを開くたびにサーバーサイドで新しいチェックアウトセッションが作成されます
* 商品バージョンと価格はアクセス時に解決されます

### チェックアウトセッション（API）

* セッションは作成時に商品バージョンと価格スナップショットをロックします
* セッションには暗号署名が含まれ、改ざんできません
* セッションはデフォルト 7 日後に期限切れになります（`expiresInSeconds` で設定可能）

<Warning>
  API 経由で作成されたチェックアウトセッションはデフォルト 7 日後に期限切れになります。期限切れ後、顧客は新しいセッションを開始する必要があります。
</Warning>