Skip to main content
本页比较四种 Apple Pay 集成方式,以及每种方式对运行环境、前端改造和 Token 处理的不同要求。Waffo 支持通过托管收银台或 Merchant 自建 Apple Pay 前端完成支付。

选择集成方式

方式一:直接外跳 Waffo 收银台

调用 /api/v1/order/create 创建订单,解析响应中的 orderAction,然后在浏览器顶层页面打开 orderAction.webUrl 这种方式由 Waffo 收银台展示 Apple Pay。你不需要在 Merchant 页面内集成 Apple Pay JS,也不需要处理 Apple Pay Token。支付结果应以 Webhook 或 /api/v1/order/inquiry 查询结果为准。

方式二:通过 App WebView 加载 Waffo 收银台

在 App 中使用 WebView 打开 orderAction.webUrl。创建订单时传 userTerminal=APP,以获取适合 App 端的跳转链接。

方式三:通过 iframe 加载 Waffo Apple Pay 收银台

iframe 方式必须使用 Waffo 前端 SDK @waffo/payment-sdk,并在接入前联系 Waffo 技术支持完成 Apple Pay 域名验证和报备。不要直接用普通 <iframe> 加载 orderAction.webUrl
前端 SDK 负责在 Merchant 页面内渲染和管理收银台 iframe。接入时还需要满足收银台 iframe 的 allow="payment"、Referrer Policy 和自适应布局要求。参见 前端 SDK 使用说明iframe 嵌入注意事项 在域名验证和报备完成前,不要上线 iframe Apple Pay。否则 Apple Pay 按钮可能无法显示,或支付授权无法继续。

方式四:Merchant 直接集成 Apple Pay

完整的准备、解密和透传格式参见 Merchant 直接集成 Apple Pay