支付

进入支付配置

绑定订单表并激活支付功能

需先创建订单表（建议包含价格、用户 ID 等字段），激活支付时选择该表。

激活后系统将自动完成以下操作：

• 创建三张表：支付表（1:N 订单）、周期性支付表、退款表（1:N 支付）
• 创建行为流：
  • 微信支付：支付、退款
  • 支付宝：支付、退款、周期性支付管理、周期性支付定时扣款

配置商户信息

微信支付（小程序端）

1. 参考 教程 ，注册企业小程序（个人小程序无法用支付）

2. 参考 微信支付商户平台  注册商户号，注册后：

• 开通 JSAPI 支付
• 配置授权目录：https://zion-app.functorz.com/
• 商户号关联小程序 AppId
• 获取商户号、APIv2 密钥
• 如需退款，获取 apiclient_cert.p12 文件，详见 微信支付规范 

3. 在 Zion 填写相关信息

配置使用支付行为

行为参数说明：

配置支付完成后的业务逻辑

支付完成后会自动触发对应的行为流。行为流内置一个“解析支付结果”的代码块，会返回四个关键参数：

在后续的条件分支中，可根据这四个参数判断支付状态，并执行相应业务逻辑。

• 第一个条件分支，用paymentFound判断是否找到对应的支付记录

  • 如果值为true，则表示找到，进入第二个条件分支
  • 如果值为false，则表示没有找到，一般不做处理。

• 第二个条件分支，用paymentStatus和alreadyProcessed判断支付状态，

  • 如果paymentStatus值为SUCCESSFUL且alreadyProcessed为false，则表示支付成功，在这个分支中配置支付成功后的业务逻辑。
  • 如果paymentStatus值为FAILED且alreadyProcessed为false，则表示支付失败，在这个分支中配置支付失败后的业务逻辑。
  • 如果以上条件都不满足，则表示 alreadyProcessed 的值为 true，说明已处理过，一般无需在该分支中配置内容。

为了安全起见，防止有人恶意利用假的订单信息进行支付或退款（让实际支付的金额远小于订单中的金额），建议添加第三个条件分支，用于检查实际的支付金额和订单中的金额是否相等。具体方法是用订单 Id 作为过滤条件，获取订单表数据和支付表数据，再进行比较。

获取支付结果

由于订单表/支付表/退款表的更新在自定义行为流中进行，且需一定时间，前端可通过订阅方式获取最新数据。例如调用支付行为后，页面可订阅支付表以实时接收支付状态变化。

配置退款行为

行为参数说明：

配置退款完成后的业务逻辑

和支付类似，退款完成后会自动触发退款行为流。其内置的“解析退款结果”代码块会返回四个关键参数：

在后续的条件分支中，可根据这四个参数判断退款状态：

• 用 refundFound 判断是否找到对应的退款记录
• 用 paymentStatus 和 alreadyProcessed 判断退款状态

由于逻辑和支付行为流类似，这里不再赘述。

获取退款结果

由于订单表/支付表/退款表的更新在自定义行为流中进行，且需一定时间，前端可通过订阅方式获取最新数据。

发起和取消

周期支付扣款

支付宝周期支付的扣款通过定时触发（每天一次）扣款行为流实现。在该行为流中，会查询到需要扣款的所有周期支付，然后用循环对每一笔周期支付进行扣款。

每次扣款都需创建一个新的订单，因此需要开发者：

1. 在循环中自主添加创建订单的行为
2. 在扣款代码块中，将创建的订单的 id 绑定到代码块的入参 orderId