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

# Apple Pay の連携

> 4 つの Apple Pay 連携方式と、実行環境、フロントエンド、トークン処理に関する各方式の要件を比較します。

このページでは、4 つの Apple Pay 連携方式と、実行環境、フロントエンド、トークン処理に関する各方式の要件を比較します。Waffo では、ホスト型 Checkout または Merchant が構築した Apple Pay フロントエンドを使って決済できます。

## 連携方式を選択する

| 方式                                      | 適用場面                                        | Merchant 側の要件                                                                                                          |
| --------------------------------------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Waffo Checkout へリダイレクト                  | Web サイト、モバイル Web、または App から独立した決済ページを開ける場合  | 注文作成後、トップレベルページで [`orderAction.webUrl`](/docs/api-reference/order-create/create-new-order#response-data) を開く                |
| App WebView で Waffo Checkout を読み込む      | ユーザーを Merchant App 内に留めたい場合                 | 注文作成時に [`userTerminal=APP`](/docs/api-reference/order-create/create-new-order#body-user-info) を送信し、WebView から外部ページを開けるようにする |
| iframe で Waffo Apple Pay Checkout を読み込む | Web または H5 で、ユーザーを新しいページへ遷移させず現在のページに留めたい場合 | Waffo フロントエンド SDK を使用し、事前にドメイン検証と申請を完了する                                                                               |
| Merchant が Apple Pay と直接連携する            | Apple Pay ボタン、決済ページ、トークン処理を完全に制御する場合        | Apple Pay フロントエンド、アカウント、証明書、ドメイン検証、トークン復号、コンプライアンス対応を自社で行う                                                             |

## 方式 1：Waffo Checkout へリダイレクトする

[`/api/v1/order/create`](/docs/api-reference/order-create/create-new-order) を呼び出し、レスポンスの [`orderAction`](/docs/api-reference/order-create/create-new-order#response-data) を解析して、ブラウザーのトップレベルページで [`orderAction.webUrl`](/docs/api-reference/order-create/create-new-order#response-data) を開きます。

この方式では、Waffo Checkout が Apple Pay を表示します。Merchant ページに Apple Pay JS を組み込む必要はなく、Apple Pay トークンを処理する必要もありません。決済ステータスは Webhook または [`/api/v1/order/inquiry`](/docs/api-reference/order-inquiry/order-inquiry) の結果を正としてください。

## 方式 2：App WebView で Waffo Checkout を読み込む

App WebView で [`orderAction.webUrl`](/docs/api-reference/order-create/create-new-order#response-data) を開きます。注文作成時に [`userTerminal=APP`](/docs/api-reference/order-create/create-new-order#body-user-info) を送信し、App 向けのリンクを取得してください。

## 方式 3：iframe で Waffo Apple Pay Checkout を読み込む

<Warning>
  iframe 連携では、Waffo フロントエンド SDK `@waffo/payment-sdk` を必ず使用してください。連携前に Waffo テクニカルサポートへ連絡し、Apple Pay のドメイン検証と申請を完了する必要があります。通常の `<iframe>` で [`orderAction.webUrl`](/docs/api-reference/order-create/create-new-order#response-data) を直接読み込まないでください。
</Warning>

フロントエンド SDK は Merchant ページ内で Checkout iframe を描画し、管理します。また、`allow="payment"`、Referrer Policy、レスポンシブレイアウトに関する Checkout iframe の要件も満たす必要があります。[フロントエンド SDK の使用方法](/docs/ja/developer-docs/integration/elements/usage#埋め込み-checkoutrenderiframe)と [iframe 埋め込みの注意事項](/docs/ja/developer-docs/integration/checkout/steps#iframe-埋め込み時の注意事項)を参照してください。

ドメイン検証と申請が完了するまで、iframe 版 Apple Pay を本番公開しないでください。Apple Pay ボタンが表示されない、または決済承認を続行できない場合があります。

## 方式 4：Merchant が Apple Pay と直接連携する

準備、復号、送信形式の詳細は、[Merchant が Apple Pay と直接連携する](/docs/ja/developer-docs/integration/apple-pay/merchant-direct-integration)を参照してください。