支付功能概述
Zion 支付能力支持通过内置支付行为完成收款、退款等操作。开发者只需在前端配置支付行为,在后端行为流配置业务逻辑,即可快速完成商业化变现闭环。
仅专业版及企业版用户可用。专业版到期将导致支付功能失效,请及时续费。
支持的支付渠道
当前 Zion 平台内置集成了以下 4 种支付能力:
- 微信支付(小程序端):适用于微信小程序环境的商品售卖、单次支付。
- 微信支付(Web 端):适用于微信公众号内的 H5 页面支付(JSAPI)。
- 支付宝(电脑网站):支持支付宝网页端一次性支付、周期订阅支付及定时扣款。
- Airwallex(空中云汇):支持国际支付、多币种单次支付及周期订阅续费。
开发者可根据具体的业务场景及终端环境,查阅对应的闭环配置指南。
激活支付
在具体配置任何一个支付渠道前,Zion 会要求你绑定一张“订单表”并激活支付功能。
Zion 对订单表中的字段没有特殊要求,开发者可以自由定义字段。但为了更好地配合支付功能,建议开发者其中至少包含金额和状态两个字段,并和账户表建立关联关系。
激活后系统将自动在你的项目中完成以下底层操作:
- 创建三张系统表:
支付表(1:N 关联订单表):记录每一笔支付流水。周期性支付表:记录用户的订阅状态。退款表(1:N 关联支付表):记录每一笔退款流水。
- 创建预设行为流: 根据你激活的渠道,系统会自动生成对应的后端 Webhook 行为流(如微信支付/退款回调、支付宝定时扣款循环等)。
所有支付产品共用同一订单表。订单表绑定后无法更换,且订单表无法删除(除非在支付配置面板中彻底关闭支付,清空所有数据后重新绑定)。
支付的运作过程
支付行为包括单次支付和退款。为了更好地配置出支付,开发者需要知道一次支付完整的运行流程。
所有支付行为都遵循下图的流程。在 Zion 中,开发者只需要配置其中的绿色部分:
-
在前端页面上使用行为:单次支付或退款
-
在对应的行为流中配置业务逻辑
-
在前端页面上查询最终结果

清空并关闭支付功能
在支付配置页面右上角有一个**“清空并关闭”**的功能按钮,请务必谨慎操作!
⚠️
关于“清空并关闭”功能
在支付配置页面执行“清空并关闭”将彻底关闭支付功能。这是一个极具破坏性且不可逆的操作,执行后会触发以下变更:
- 擦除敏感配置:彻底清空所有支付渠道的 API Key、商户号等底层配置数据。
- 销毁数据表:强制删除系统自动生成的支付表、周期性支付表、退款表及其关联关系。项目发布至后端后,这三张表对应的线上历史数据也将被永久清除。
- 移除行为逻辑:删除所有支付预设行为流与回调触发器。项目中所有已绑定支付相关行为的逻辑将因此失效。
注意:关闭后再重新激活支付功能时,系统会创建一套全新的数据表、行为流和回调触发器,无法与此前的数据关联。
Last updated on