Airwallex 支付

准备 Airwallex 账户

登录 Airwallex 的测试环境 或生产环境 。在 Settings → Developers → API Keys 创建 API 密钥并保存 Client ID。API 密钥只在创建时显示；遗失后需要重新生成。

如果账户使用法定实体或关联支付账户，还需要在 Settings → Entities 获取 Legal entity ID 和 Linked payment account ID。

激活 Airwallex

打开 行为 → 支付 → Airwallex（Web），点击 激活。如果这是项目中第一个支付渠道，请选择订单表。

激活后，从 关联行为流 打开系统生成的 Airwallex 支付处理行为流，点击顶部的 Webhook 触发器并复制 Webhook 地址。

创建 Airwallex Webhook

在 Airwallex 控制台打开 Settings → Webhooks，创建 Webhook：

• API version：固定填写 2025-11-11。
• Account：选择 Linked payment account ID 对应的账户；未使用关联支付账户时选择当前收款账户。
• Notification URL：填写 Airwallex 支付处理行为流的 Webhook 地址。
• Events：勾选以下事件。

payment_intent.succeeded
payment_intent.cancelled
invoice.finalized
subscription.in_trial
subscription.active
subscription.unpaid
subscription.cancelled
subscription.modified
refund.accepted
refund.failed

创建后复制 Webhook secret。

填写支付配置

保存并发布支付配置、系统表、行为流和页面修改。测试配置只能配合 Airwallex 测试环境使用，不能与生产凭证混用。

创建订单并添加行为

先在已绑定的订单表中创建订单，再从组件触发器的 支付 菜单添加 Airwallex → 单次支付。

建议用户点击后立即禁用支付按钮，直到支付行为返回或收银台关闭，避免重复拉起收银台。

支付行为的 成功时 表示前端调用已成功返回，不能配置修改数据的行为。最终结果由 Webhook 确认。

处理支付回调

Airwallex 支付处理行为流的同步支付状态节点提供：

仅当 paymentId 有值、paymentStatus 为 SUCCESSFUL 且 alreadyProcessed 为 false 时执行支付成功逻辑。发货或发放权益前，应核对订单金额、币种和支付记录。

配置权限并添加行为

退款行为默认不向普通用户开放。在 设置 → 权限 → 支付 中，只为可信任的管理员角色开启 Airwallex 退款权限。

从 支付 菜单添加 Airwallex → 退款：

发起退款前，应查询成功退款记录并检查累计退款金额。

处理退款回调

同步退款状态节点提供：

仅当 refundId 有值且 alreadyProcessed 为 false 时，根据 status 处理订单、权益和通知。

发起订阅

添加 Airwallex → 周期支付 → 发起。

前端分支只表示订阅授权交互结果。订阅是否生效必须以 Webhook 同步后的周期性支付记录为准。

取消订阅

添加 Airwallex → 周期支付 → 取消，并绑定需要取消的 周期支付表 id。

处理订阅状态

Airwallex 支付处理行为流会接收 subscription.in_trial、subscription.active、subscription.unpaid、subscription.cancelled 和 subscription.modified 等事件，并同步周期性支付表。

同步结果包括 recurringPaymentId 和 status。系统保存的状态包括 INCOMPLETE、TRIALING、ACTIVE、UNPAID 和 CANCELED；subscription.modified 是 Webhook 事件，不是名为 MODIFIED 的订阅状态。

根据业务需要，在 ACTIVE、CANCELED 或其他状态分支中启用、暂停或收回订阅权益。

配置续费订单

invoice.finalized 会进入订阅续费处理。系统根据 Invoice ID 获取或创建当期支付记录，并打开 Airwallex 订阅续费处理行为流。

在该行为流预留的创建订单位置：

1. 根据首次订阅订单创建本期业务订单，并填写金额、账户和其他业务字段。
2. 将新增订单的 id 交给后续系统节点，使当期支付记录关联该订单。
3. 在对应支付回调确认成功后，再发放本期权益。

模板会检查当期支付记录是否已有订单 id，以避免重复创建续费订单；用户添加的其他业务节点仍需自行保证幂等。