> ## 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 集成中按支付方式和接入环境整理的注意事项。

不同支付方式在 App、WebView、iframe 和跳转回调上可能有不同要求。本文只保留真正容易踩坑的特殊注意事项，适合在选择支付方式或设计集成方式时快速查阅。

本文不是完整的支付方式可用性列表。支付方式是否可用以商户合约、Portal Payin 配置和 `paymethodconfig/inquiry` 返回结果为准。

支付结果始终以 Webhook 或主动查询为准，不要只依赖用户重定向 URL。

## 通用能力检查

| 事项          | 适用支付方式或环境                                                     | 需要注意什么                         | 建议做法                                                                                       |
| ----------- | ------------------------------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------ |
| 外部跳转能力      | 需要跳转到钱包 App 或外部授权页的支付方式；App WebView                           | 部分钱包会通过 deeplink 或外部浏览器完成授权    | 确认 App 和 WebView 允许打开外部 App 或外部浏览器；根据 `orderAction.actionType` 使用 `webUrl` 或 `deeplinkUrl` |
| 下载、复制、保存能力  | QR、OTC、银行转账；App WebView                                       | 这些支付方式可能依赖下载二维码、复制支付信息或长按保存    | 实现下载监听、复制和长按保存等交互；不要假设 WebView 默认支持这些能力                                                    |
| 回跳 URL 参数保真 | PayPay Smart Payment 等依赖回跳参数的支付方式；App 与 WebView 间 URL 传递      | 渠道可能会在 `redirectUrl` 上追加参数     | 不要改写 URL 或丢弃 query 参数；完整保留渠道追加的参数                                                          |
| iframe 支付能力 | Google Pay、WeChat Pay 等依赖浏览器支付能力或来源信息的支付方式；iframe 嵌入 Checkout | 这类支付方式可能依赖浏览器支付能力或 Referrer 信息 | iframe 添加 `allow="payment"`；Referrer Policy 设置为 `strict-origin-when-cross-origin`          |

## 支付方式特例

| 支付方式                 | 适用环境                         | 为什么要注意                                                                                                                                                                                     | 建议做法                                                                                                                             |
| -------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| PayPay Smart Payment | 商户 App WebView               | [PayPay 官方说明不支持在商户 App WebView 内直接使用](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                                                                                             |
| Google Pay           | 虚拟商品、App WebView、iOS WebView | 虚拟商品场景不能在 App WebView 内加载；iOS WebView 可能需要额外配置                                                                                                                                             | 外跳浏览器；必要时按 Google Pay 文档调整 WKWebView 配置                                                                                          |
| Apple Pay            | H5 页面或 PC 页面内 iframe 嵌入      | 必须使用 Waffo 前端 SDK，并提前联系 Waffo 技术支持完成域名验证和报备                                                                                                                                                | 不要直接用普通 iframe 加载收银台；按 [Apple Pay 集成](/docs/zh/developer-docs/integration/apple-pay/overview#方式三通过-iframe-加载-waffo-apple-pay-收银台)完成接入 |
| JKOPAY               | iframe 嵌入 Checkout           | 不支持 iframe 加载                                                                                                                                                                              | 改用重定向或 `window.open` 打开收银台                                                                                                       |

## 相关规则入口

* 传参规则见 [收银台集成 - 定制化选项](/docs/zh/developer-docs/integration/checkout/customization)
* 高频问答见 [常见问题 FAQ](/docs/zh/developer-docs/tools-and-references/references/faq)