空中云汇支付（Airwallex）

站内不跳转的 Airwallex 收银台：顾客在结账页内直接完成卡片支付与 3D Secure 验证。

功能

• 站内支付不跳转：用 Airwallex.js 在结账页内渲染卡号 / 有效期 / CVV 输入框，3DS 也以当前页面浮层完成，卡片信息全程不经过本站。
• 两种收银台样式：内嵌卡号表单（纯站内，推荐）与 Drop-in 聚合收银台（含支付宝、微信、Apple Pay 等，部分钱包会跳转到 App 或外部页面）。
• 服务端定价：支付金额与币种始终按订单在服务端计算，前端只拿到支付单标识与一次性密钥，无法篡改。
• 支付结果二次核验：前端支付完成后，服务端再向 Airwallex 查询真实状态，并核对订单号、金额与币种。
• Webhook 回调：用 x-signature + x-timestamp 做 HMAC-SHA256 验签，并校验 5 分钟时间窗防重放；未配置签名密钥时一律拒绝回调（fail-closed）。
• 扣款模式可选：「授权并立即扣款」（推荐）与「仅授权，稍后手动扣款」。
• 退款能力：提供全额 / 部分退款接口，需要在自定义控制器或命令行中调用。
• 零位小数货币：自动识别 JPY、KRW 等货币并按整数金额提交。

使用

1. 在 Airwallex 商户后台「开发者 → API 密钥」复制 Client ID 与 API Key。
2. 在 Airwallex 商户后台「开发者 → Webhooks」新建 Endpoint，Notification URL 填 https://你的域名/callback/bk_airwallex，订阅 payment_intent.succeeded（使用「仅授权」模式时再加 payment_intent.requires_capture），保存后复制 Webhook Secret。
3. 后台「插件管理 → Airwallex 空中云汇支付」安装并启用，在设置页填写 Client ID、API Key、Webhook 签名密钥三项（均必填，设置页顶部会显示本站确切的回调地址，可直接复制），保存。
4. 结账页的支付方式列表出现 Airwallex；顾客在页面内完成支付，成功后跳转到下单成功页。
5. 上线前把「沙箱（测试）模式」关闭，并为正式环境单独配置 Webhook Secret（沙箱与正式的密钥不同）。