支付功能

该能力可以让zion的用户通过内置的支付行为完成收款、退款等操作。目前已经支持微信小程序的支付、微信H5支付、支付宝网页端一次性支付和支付宝周期订阅支付。

该能力仅专业版及企业版用户可用,如需使用,请将项目升级到所需版本。若专业版到期，也将导致支付功能失效，请注意及时续费。

使用教程

第一步：配置支付所需基础信息

1. 打开配置-支付

2. 绑定订单表并激活支付功能。需要先创建一张自己的订单表，订单表中的字段没有硬性要求，建议包含价格、用户id等字段。在激活支付时选择这张表，注意：

   • 支付宝和微信支付共用这一张订单表
   • 绑定后将无法解绑或换绑，且订单表将无法删除

   

3. 配置商户信息

   • 微信商户号
     1. 注册企业小程序（个人小程序无法使用支付），链接：企业小程序
     2. 注册微信商户号，教程：如何申请商户号。注册后完成下列步骤：
        1. 开通：产品中心 - 我的产品 - JSAPI支付
        2. 授权：产品中心 - 开发配置 - JSAPI支付 - 授权目录：https://zion-app.functorz.com/
        3. 关联小程序：产品中心 - AppID账号管理 - 关联 AppID 将小程序的 AppID（在微信公众平台的基本设置里或Zion预发布界面中找到）填入之后确认绑定
     3. 从商户号获取信息，并填入支付配置
        • 商户号ID：产品中心 - 开发配置 - 商户号
        • 商户号API Key：账号中心 - API安全 - APIv2密钥
        • 如需要退款功能，还需要获取 apiclient_cert.p12 文件，见 微信支付规范 中“API证书”的部分

   

   • 支付宝商户号
     1. 注册商户号（目前支持电脑网站支付的方式和服务商代开发模式），链接：支付宝接入准备
     2. 从支付宝开放平台获取信息，并填入支付配置
        1. Appid
        2. 用户私钥/支付宝公钥：可以通过下载支付宝开放平台开发助手生成，目前 Zion 仅支持 RSA2 加密协议的公私钥

   

4. 在绑定订单表并激活后，系统将自动完成以下操作：

   • 创建三张表
     • 支付表：用于保存支付记录。订单表1:N支付表，因此一笔订单可以有多笔支付。
     • 周期性支付表：保存周期支付的记录。
     • 退款表：用于保存退款记录。支付表1:N退款表，因此一笔支付可以分多次退款。
   • 创建四个行为流
     • 支付行为流：一次性支付完成后自动触发
     • 退款行为流：退款完成后自动触发
     • 周期支付行为流：发起或取消时触发
     • 周期扣款行为流：定时触发

第二步：使用支付行为

支付、退款、发起或取消周期支付，都遵循下图的流程。开发者只需要配置其中的绿色部分：

1. 在前端页面上使用行为：发起支付、退款或周期支付
2. 在对应的行为流中配置业务逻辑
3. 在前端页面上查询最终结果

一次性支付和退款

1. 使用支付/退款行为

   

   行为参数说明：

   行为类型	参数	说明
   支付	订单表ID	整数，必须是绑定的订单表里某一行的ID（因此建议先添加订单，成功时调用支付行为）。
   	金额	小数，单位为元，小数点后不能超两位，且必须大于0.01。
   	商品介绍（微信支付）	文本，商品的描述。
   	商品名称（支付宝）	文本，可以是商品的标题/交易标题/订单标题/订单关键字等。
   退款	支付表ID	整数，可以用订单ID作为过滤条件，获取对应的支付表ID。
   	退款金额	小数，单位为元，小数点后不能超两位。同一笔支付可以发起多次退款，退款金额的总和不能超过支付的总金额。

2. 配置支付或退款完成后的业务逻辑

   支付或退款完成后将触发对应的行为流，行为流内置了一个代码块对结果分析，并返回关键信息。开发者需要在后续的分支中，自行配置业务逻辑。

   参数	说明
   orderId	调用支付行为时填写的orderId，可以用它找到对应的订单记录，并更新其状态
   paymentStatus	支付状态：REDUNDED - 退款成功，FAILED - 退款失败
   callbackProgressed	用于判断是否为重复触发/td>

   

3. 获取支付结果

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

   

周期支付

周期支付涉及到发起、取消、扣款几个步骤

1. 发起和取消

   

   类型	参数	说明
   发起	订单表ID	整数，必须是绑定的订单表里某一行的ID（因此建议先添加订单，成功时调用支付行为）。
   	价格	小数，单位是元，小数点后不超过两位。由于支付宝的限制，只能支持100元以内的周期支付
   	商品名称	文本
   	扣款间隔	整数，扣款间隔不能少于7天，无最大限制
   	场景	文本，只能填支付宝规定的 场景值 （例如：INDUSTRY|LOTTERY）。同一个用户对同一个场景只能订阅一次
   取消	周期支付表ID	整数，可以用用户ID作为过滤条件获取到对应的周期支付记录

2. 周期支付扣款

   通过定时触发扣款行为流，查询到需要扣款的周期支付，每个扣款，都需要创建一个新的订单

   

第三步：权限配置

在权限系统中可以配置行为的权限。尤其是退款行为（权限默认关闭），建议对普通用户关闭，否则可能会造成金钱上的损失。更正确的做法是新建一个类似管理员的角色，给它开放退款权限。

注意事项

H5端使用微信支付

如需在H5端使用微信支付，需要一些额外的配置

1. 准备公众号

   1. 必须是服务号，且已认证

   2. 需要在公众号中进行网页授权域名，用web发布地址中的域名(配自定义域名后用自定义域名)

      

2. 商户号授权：需要在商户号中配置支付授权目录，地址是web的发布地址(配自定义域名后用自定义域名)

3. Zion里的配置：Web端必须使用微信授权登录，授权用公众号AppID和APP Secret

   

常见报错处理办法

1. 微信支付
   • 调用支付行为报错：JSAPI缺少参数 total-fee
   • 检查支付的参数是否正确（例如：确保金额有值且大于0.01）
   • 前往商户号检查其状态是否正常

2. 支付宝

   • 发起支付宝周期支付，用户在支付宝端显示“商户协议状态不正常” 查看周期支付表中是否有同一个账户多次订阅的情况，由于支付宝限制一个用户只能用一个场景码订阅一次，因此如果有一个用户订阅多次的情况，请保证发起周期支付的行为中场景码不同

     

   • 退款成功后，回调行为流没有触发

   • 由于支付宝的限制，如果是全额退款，不会触发行为流。