Skip to Content
帮助文档行为配置操作指南支付支付功能概述

支付功能概述

Zion 支付能力支持通过内置支付行为完成收款、退款等操作。开发者只需在前端配置支付行为,在后端行为流配置业务逻辑,即可快速完成商业化变现闭环。

专业版及企业版用户可用。专业版到期将导致支付功能失效,请及时续费。

支持的支付渠道

当前 Zion 平台内置集成了以下 4 种支付能力:

  1. 微信支付(小程序端):适用于微信小程序环境的商品售卖、单次支付。
  2. 微信支付(Web 端):适用于微信公众号内的 H5 页面支付(JSAPI)。
  3. 支付宝(电脑网站):支持支付宝网页端一次性支付、周期订阅支付及定时扣款。
  4. Airwallex(空中云汇):支持国际支付、多币种单次支付及周期订阅续费。

开发者可根据具体的业务场景及终端环境,查阅对应的闭环配置指南。

激活支付

在具体配置任何一个支付渠道前,Zion 会要求你绑定一张“订单表”并激活支付功能

Zion 对订单表中的字段没有特殊要求,开发者可以自由定义字段。但为了更好地配合支付功能,建议开发者其中至少包含金额和状态两个字段,并和账户表建立关联关系。

激活后系统将自动在你的项目中完成以下底层操作:

  • 创建三张系统表
    • 支付表(1:N 关联订单表):记录每一笔支付流水。
    • 周期性支付表:记录用户的订阅状态。
    • 退款表(1:N 关联支付表):记录每一笔退款流水。
  • 创建预设行为流: 根据你激活的渠道,系统会自动生成对应的后端 Webhook 行为流(如微信支付/退款回调、支付宝定时扣款循环等)。

所有支付产品共用同一订单表。订单表绑定后无法更换,且订单表无法删除(除非在支付配置面板中彻底关闭支付,清空所有数据后重新绑定)。

支付的运作过程

支付行为包括单次支付和退款。为了更好地配置出支付,开发者需要知道一次支付完整的运行流程。

所有支付行为都遵循下图的流程。在 Zion 中,开发者只需要配置其中的绿色部分

  1. 在前端页面上使用行为:单次支付或退款

  2. 在对应的行为流中配置业务逻辑

  3. 在前端页面上查询最终结果

    支付流程图

清空并关闭支付功能

在支付配置页面右上角有一个**“清空并关闭”**的功能按钮,请务必谨慎操作!

⚠️

关于“清空并关闭”功能

在支付配置页面执行“清空并关闭”将彻底关闭支付功能。这是一个极具破坏性且不可逆的操作,执行后会触发以下变更:

  1. 擦除敏感配置:彻底清空所有支付渠道的 API Key、商户号等底层配置数据。
  2. 销毁数据表:强制删除系统自动生成的支付表、周期性支付表、退款表及其关联关系。项目发布至后端后,这三张表对应的线上历史数据也将被永久清除
  3. 移除行为逻辑:删除所有支付预设行为流与回调触发器。项目中所有已绑定支付相关行为的逻辑将因此失效。

注意:关闭后再重新激活支付功能时,系统会创建一套全新的数据表、行为流和回调触发器,无法与此前的数据关联。

Last updated on