決済手段別の連携注意事項 - Waffo Documentation

決済手段によって、アプリ、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 を直接使用できないと説明しています。リダイレクト時に `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 の連携に従います
JKOPAY	iframe Checkout	iframe 読み込みに対応していません	リダイレクトまたは `window.open` で Checkout を開きます

関連ルールの入口

payMethodType、payMethodName、payMethodCountry のルールは Checkout customization を参照してください
よくある質問は FAQ を参照してください