支付宝支付

准备支付宝应用

按照支付宝接入准备 注册商户并创建网页应用。接口加签方式选择密钥，算法使用 RSA2。

通过支付宝开放平台密钥工具生成应用私钥，并在应用的开发设置中获取支付宝公钥。不要把应用公钥误填为支付宝公钥。

Zion 会管理支付结果的通知地址，无需在支付配置中填写应用网关或 Webhook 地址。

激活支付宝

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

填写商户信息

保存后，支付配置中的 关联行为流 会显示支付和退款处理、周期支付处理及周期支付扣款处理等系统流程。

发布并测试

发布支付配置、系统表、行为流和页面修改。先使用支付宝沙盒或受控金额测试，再切换到正式业务。

创建订单并添加行为

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

支付行为的 成功时 用于处理前端调用结果，不能配置修改数据的行为。最终支付状态由支付宝回调确认。

处理支付回调

支付宝的支付和退款共用系统生成的 支付和退款处理行为流。支付分支会更新支付表，并提供：

仅当 paymentFound 为 true 且 alreadyProcessed 为 false 时，根据 paymentStatus 处理订单。支付成功前应核对订单和支付记录中的金额。

配置权限并添加行为

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

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

处理退款结果

支付和退款处理行为流的退款分支会更新退款表，并提供 orderId、refundFound、paymentStatus 和 alreadyProcessed。paymentStatus 为 REFUNDED 或 FAILED。

发起周期支付

从 支付 菜单添加 支付宝支付 → 周期支付 → 发起。

同一用户不能用相同场景重复创建周期支付。不同订阅业务应使用符合支付宝规范的不同场景值。

取消周期支付

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

处理订阅状态

系统生成的周期支付处理行为流负责同步订阅状态。根据业务需要，在其预留分支中启用或停用订阅权益。

配置周期扣款订单

支付宝周期支付扣款由系统生成的定时行为流执行。每次扣款都需要一条新的业务订单，因此需要在行为流预留位置：

1. 根据周期支付记录创建新的订单。
2. 将新订单的 id 绑定到后续扣款节点的 orderId 入参。
3. 在支付回调确认成功后，再更新订单和发放本期权益。