支付功能概述

Zion 支付功能可接入微信支付、支付宝、Stripe 和 Airwallex 四种支付渠道，满足单次支付、周期支付和退款等常见需求。对接渠道、确认支付结果、记录交易这些繁琐的环节都由 Zion 完成，开发者只需要完成填写商户信息等几个步骤，就可以便捷地接入支付功能。

支付渠道

一个项目可以同时使用多个支付渠道，同一渠道也可以接入多个商户号。

支付功能

• 单次支付：用户下单后一次性付款，例如购买商品、课程或会员。
• 周期支付：按周期自动扣款，适合会员订阅、套餐续费等持续收费的业务。
• 退款：对已支付的订单全额或部分退款。

支付完成、退款成功或周期支付状态变化后，Zion 会自动更新支付记录，并运行你指定的行为流，完成更新订单、发放权益等后续业务。

配置步骤

所有支付渠道的配置都遵循以下步骤：

发起支付

在页面或组件的触发器中添加 支付 行为，然后依次设置：

选择支付配置后，行为会切换为对应渠道的参数，例如订单表 id、金额和商品名称。各渠道的参数和金额单位见对应的渠道指南。

前端结果与最终支付状态

支付行为提供 成功时 和 失败时，用于处理前端请求或收银台交互的结果。出于安全考虑，支付行为的 成功时 不能配置修改数据的行为。

订单是否真正支付成功，以支付平台的通知为准。不要只根据前端的 成功时 发货、发放权益或把订单更新为已支付。

处理支付结果

用户完成支付、退款或订阅续费后，支付平台会向 Zion 发送通知。Zion 校验通知签名、更新系统表中的状态，再按事件类型运行你绑定的行为流。

支付事件

支付被取消或支付失败时不会触发任何事件。退款成功时 会在退款成功和退款失败时都触发，需要在行为流中根据退款记录的 状态 分别处理。

绑定行为流

运行规则

• Zion 先更新系统表，再运行你的行为流。行为流中查询到的支付、退款或订阅记录已经是最新状态。
• 只有状态真正发生变化时才会触发事件。支付平台重复发送同一条通知，不会重复运行行为流。
• 行为流以管理员身份运行，不受当前用户的数据权限限制。
• Zion 收到通知后会先答复支付平台，再运行行为流。行为流运行失败不会重试，可以在运行日志中排查。发货、发放权益和扣减库存等节点仍应使用订单状态条件或唯一约束保证幂等。

处理订阅续费

订阅续费时 用于为新一期账单创建业务订单。Zion 已经为这一期创建了支付记录，但没有关联订单。绑定的行为流必须满足：

• 使用 同步执行。
• 出参为一个长整数，值为新建订单的 id。

Zion 把这个订单 id 写回本期支付记录。之后这笔扣款成功时，会触发 支付完成时，并带上该订单。行为流不满足这两条要求时，编辑器会提示错误；没有返回订单 id 时，这一期的支付记录不会关联订单。

校验订单金额

支付金额来自前端行为的参数。发货或发放权益前，建议在 支付完成时 的行为流中查询订单，比对订单金额与 订单已支付金额（该订单所有成功支付记录的金额合计）和币种。

查询支付结果

前端可以查询订单表，也可以按数据权限查询支付、周期性支付和退款系统表。绑定订单表时，Zion 会为已登录用户角色开放这三张表的查询权限。需要及时刷新状态时，可以使用实时数据源或重新查询页面数据。

删除支付配置

在支付配置卡片上点击删除，确认后会同时删除该配置的支付结果处理绑定和权限配置，且无法恢复。引用该配置的支付行为需要重新选择支付配置。

停用所有支付

支付页面提供 停用所有支付。确认后会执行不可逆操作：

1. 删除全部支付配置和支付结果处理绑定。
2. 删除支付、周期性支付和退款系统表及其关联；发布后，线上历史数据也会被删除。