选择集成方式
方式一:直接外跳 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 收银台
前端 SDK 负责在 Merchant 页面内渲染和管理收银台 iframe。接入时还需要满足收银台 iframe 的allow="payment"、Referrer Policy 和自适应布局要求。参见 前端 SDK 使用说明和 iframe 嵌入注意事项。
在域名验证和报备完成前,不要上线 iframe Apple Pay。否则 Apple Pay 按钮可能无法显示,或支付授权无法继续。