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

# 決済手段別の連携注意事項

> Checkout 連携における決済手段と利用環境ごとの注意事項。

決済手段によって、アプリ、WebView、iframe、リダイレクトに関する要件が異なる場合があります。このページは、本当に見落としやすい特殊な注意点だけをまとめたクイックリファレンスです。

このページは利用可能な決済手段の完全な一覧ではありません。利用可否は加盟店契約、Portal の Payin 設定、`paymethodconfig/inquiry` のレスポンスを正としてください。

決済結果は必ず Webhook または能動的な照会を正としてください。ユーザーのリダイレクト URL だけに依存しないでください。

## 共通の能力チェック

| 項目 | 適用される決済手段または環境 | 注意点 | 推奨対応 |
| - | - | - | - |
| 外部起動機能 | ウォレット App や外部認可ページへ遷移する決済手段；App WebView | 一部のウォレットは deeplink または外部ブラウザで認可を完了します | App と WebView が外部 App やブラウザページを開けることを確認し、`orderAction.actionType` に応じて `webUrl` または `deeplinkUrl` を使います |
| ダウンロード、コピー、保存機能 | QR、OTC、銀行振込；App WebView | QR ダウンロード、支払い情報コピー、長押し保存が必要になる場合があります | ダウンロードリスナー、コピー、保存動作を実装します。WebView が既定で対応していると仮定しないでください |
| リダイレクト URL パラメータの保持 | PayPay Smart Payment など回跳パラメータに依存する決済手段；App と WebView 間の URL 受け渡し | 決済チャネルが `redirectUrl` にパラメータを追加する場合があります | URL を書き換えたり query パラメータを削除したりせず、追加されたパラメータを完全に保持します |
| iframe の決済機能 | Google Pay、WeChat Pay などブラウザ決済 API や Referrer 情報に依存する決済手段；iframe Checkout | ブラウザ決済機能や Referrer 情報に依存します | iframe に `allow="payment"` を追加し、Referrer Policy を `strict-origin-when-cross-origin` に設定します |

## 決済手段ごとの特例

| 決済手段 | 適用環境 | なぜ注意が必要か | 推奨対応 |
| - | - | - | - |
| PayPay Smart Payment | 加盟店 App WebView | [PayPay は加盟店アプリの WebView 内で Smart Payment を直接使用できないと説明しています](https://integration.paypay.ne.jp/hc/en-us/articles/11964096091407-Smart-Payment-can-not-be-used-on-a-Merchant-App-s-Webview)。リダイレクト時に `one_time_token` が追加されます | App WebView では外部ブラウザで PayPay を開くか、その環境では PayPay を非表示にします |
| Google Pay | バーチャルグッズ、App WebView、iOS WebView | バーチャルグッズでは App WebView 内で読み込めず、iOS WebView では追加設定が必要な場合があります | 外部ブラウザで開き、必要に応じて Google Pay の案内に従って WKWebView を調整します |
| Apple Pay | H5 またはデスクトップページで iframe 埋め込み | Waffo フロントエンド SDK を使用し、事前に Waffo テクニカルサポートへ連絡してドメイン検証と申請を完了する必要があります | 通常の iframe で Checkout を直接読み込まず、[Apple Pay の連携](https://waffo.com/docs/ja/developer-docs/integration/apple-pay/overview.md#方式-3iframe-で-waffo-apple-pay-checkout-を読み込む)に従います |
| JKOPAY | iframe Checkout | iframe 読み込みに対応していません | リダイレクトまたは `window.open` で Checkout を開きます |

## 関連ルールの入口

* `payMethodType`、`payMethodName`、`payMethodCountry` のルールは [Checkout customization](https://waffo.com/docs/ja/developer-docs/integration/checkout/customization.md) を参照してください
* よくある質問は [FAQ](https://waffo.com/docs/ja/developer-docs/tools-and-references/references/faq.md) を参照してください


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