支付方式集成注意事项 - Waffo Documentation

不同支付方式在 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 内直接使用。回跳时会追加 `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 集成完成接入
JKOPAY	iframe 嵌入 Checkout	不支持 iframe 加载	改用重定向或 `window.open` 打开收银台

相关规则入口

传参规则见收银台集成 - 定制化选项
高频问答见常见问题 FAQ

常见问题（FAQ）订阅支付方式对比

⌘I