不同支付方式在 App、WebView、iframe 和跳转回调上可能有不同要求。本文只保留真正容易踩坑的特殊注意事项，适合在选择支付方式或设计集成方式时快速查阅。 本文不是完整的支付方式可用性列表。支付方式是否可用以商户合约、Portal Payin 配置和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.
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 内直接使用。回跳时会追加 one_time_token | App WebView 场景外跳浏览器，或在该场景下不展示 PayPay |
| Google Pay | 虚拟商品、App WebView、iOS WebView | 虚拟商品场景不能在 App WebView 内加载；iOS WebView 可能需要额外配置 | 外跳浏览器；必要时按 Google Pay 文档调整 WKWebView 配置 |
| Apple Pay | H5 页面或 PC 页面内 iframe 嵌入 | iframe 内不可用 | 不要在 iframe 内使用；改用顶层页面跳转、window.open 或 App WebView |
| JKOPAY | iframe 嵌入 Checkout | 不支持 iframe 加载 | 改用重定向或 window.open 打开收银台 |
相关规则入口
- 传参规则见 收银台集成 - 定制化选项
- 高频问答见 常见问题 FAQ