银企支付-详细设计文档

淡淡的烟草味﹌ 2023-06-08 06:41 459阅读 0赞

*  银企支付-详细设计文档
    
     *  1、定义说明
     *  2、借款单
     *  3、报销单
     *  4、银企互联
     *  5、执行流程日志
     *  6、监控
     *  7、差错处理
     *  8、数据库设计

## 银企支付-详细设计文档 ##

--------------------

本文介绍企业在借款单，报销单走银企支付流程时的详细设计。本文重点介绍整个流程需要关注的细节点，在最终实现时，对于数据表具体字段，不做介绍。

### 1、定义说明 ###

*  报销金额：申请报销人，填写的当次需要报销的总金额。
 *  借款金额：申请借款人，填写的当次需要借款的金额。
 *  核销金额：指在报销时，本身又存在借款金额未还时，报销中，自动还款的金额，称为核销金额。如：借款1000元未还，报销3000元，若本次要抵消借款的1000元，则核销金额为1000元。核销金额小于等于还款金额。
 *  实际报销交易金额：指报销时，报销金额减去核销金额后的余额。如：核销1000元，报销3000元，实际报销交易金额为2000元。

### 2、借款单 ###

#### 2.1、借款单流程 ####

*  借款单走银企支付：通过银行，公司账户把借款金额转账给申请借款人账户。
 *  借款单走内部转账：内部转账，变动相关账户虚拟金额。  
    ![www.wityx.com][]

##### 校验 #####

<table> 
 <thead> 
  <tr> 
   <th>项目</th> 
   <th>校验规则</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>支付方式验证</td> 
   <td>支付方式支持系统转账，浦发银行银企支付</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>支付方银行卡号验证</td> 
   <td>当支付类型为银企模式时，支付的银行卡号必须存在,接收方的银行卡号必须存在</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>单据编码验证</td> 
   <td>请求交易的单据编码数据合规性验证</td> 
   <td>如编码可信性，准确性，是否已经在处理过程中</td> 
  </tr> 
  <tr> 
   <td>币别验证</td> 
   <td>系统支持的交易币别类型验证</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>支付方式限定</td> 
   <td>不同币别仅支持系统转账</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>支付方式限定</td> 
   <td>银企支付仅支持币别人民币</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>汇率正确性</td> 
   <td>币别转账时，汇率值合规性验证</td> 
   <td>针对工作人员填写的汇率，做合规性验证</td> 
  </tr> 
  <tr> 
   <td>用户信息验证</td> 
   <td>查看系统中是否存在申请人员的信息</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>申请人账号验证</td> 
   <td>查看系统中申请人银行账户信息是否正确</td> 
   <td>无</td> 
  </tr> 
 </tbody> 
</table>

##### 风控 #####

<table> 
 <thead> 
  <tr> 
   <th>项目</th> 
   <th>规则</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>额度</td> 
   <td>单笔借款额度在xx万以内</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>及时还款情况</td> 
   <td>若存在xx笔以上借款未还款，不可在借款</td> 
   <td>无</td> 
  </tr> 
 </tbody> 
</table>

##### 路由 #####

<table> 
 <thead> 
  <tr> 
   <th>项目</th> 
   <th>规则</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>银企支付</td> 
   <td>调用银行接口，由公司银行账户，转账给借款申请人的个人银行账号。系统层面记录个人，公司虚拟账户金额变动情况。</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>系统转账</td> 
   <td>财务通过其他途径转账给申请人，系统层面记录个人，公司虚拟账户金额变动情况。</td> 
   <td>无</td> 
  </tr> 
 </tbody> 
</table>

##### 银企支付 #####

转账金额：申请人申请的借款金额。  
调用银行对外封装的接口，做转账业务。不同银行的逻辑不同，本文以浦发银行为例。详情参考银企支付设计模块。

##### 业务处理 #####

当银行处理借款业务成功后，或用户直接选择系统内转账时，调用业务处理模块。整个业务处理模块采用事务模式，保证账户变化，流水记录等相关数据操作必须满足一致性的需求。

<table> 
 <thead> 
  <tr> 
   <th>项目</th> 
   <th>规则</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>转入流水金额</td> 
   <td>申请人借款成功，写入的一条借款者入账流水到流水表。</td> 
   <td>流水金额为借款金额</td> 
  </tr> 
  <tr> 
   <td>转出流水金额</td> 
   <td>支付借款金额的账户，写入一条转出流水到流水表。</td> 
   <td>流水金额为借款金额</td> 
  </tr> 
  <tr> 
   <td>手续费</td> 
   <td>目前不存在交易手续费</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>转账日志</td> 
   <td>记录转账相关的明细信息。</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>终态确定</td> 
   <td>最终完善该条借款单据的处理结果。</td> 
   <td>是否借款成功</td> 
  </tr> 
 </tbody> 
</table>

##### 执行流程日志 #####

流程日志记录单据从开始执行支付业务时，在不同节点的处理过程日志。详情查看流程日志设计模块。

#### 2.2、数据流向说明 ####

### 3、报销单 ###

#### 3.1、报销单流程 ####

*  报销单走银企支付：通过银行，公司账户把实际报销金额转账给申请借款人账户。
 *  报销单走内部转账：内部转账，变动相关账户虚拟金额。
 *  报销单可关联相关账户的借款信息，自动核销借款记录。  
    ![www.wityx.com][www.wityx.com 1]

报销业务分为三种情况：

1.  核销金额为零（不选择抵消借款，或无需要核销的借款记录）
2.  核销金额小于报销金额
3.  核销金额等于报销金额。

##### 校验 #####

<table> 
 <thead> 
  <tr> 
   <th>项目</th> 
   <th>校验规则</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>支付方式验证</td> 
   <td>支付方式支持系统转账，浦发银行银企支付</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>单据编码验证</td> 
   <td>请求交易的单据编码数据合规性验证</td> 
   <td>如编码可信性，准确性，是否已经在处理过程中</td> 
  </tr> 
  <tr> 
   <td>币别验证</td> 
   <td>系统支持的交易币别类型验证</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>支付方银行卡号验证</td> 
   <td>当支付类型为银企模式时，支付的银行卡号必须存在,接收方的银行卡号必须存在</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>支付方式限定</td> 
   <td>不同币别仅支持系统转账</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>支付方式限定</td> 
   <td>银企支付仅支持币别人民币</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>汇率正确性</td> 
   <td>币别转账时，汇率值合规性验证</td> 
   <td>针对工作人员填写的汇率，做合规性验证</td> 
  </tr> 
  <tr> 
   <td>用户信息验证</td> 
   <td>查看系统中是否存在申请人员的信息</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>申请人账号验证</td> 
   <td>查看系统中申请人银行账户信息是否正确</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>支付方式验证</td> 
   <td>报销实际交易金额小于等于零时，不可选择银企支付</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>报销实际交易金额</td> 
   <td>报销实际交易金额必须大于等于零</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>核销金额验证</td> 
   <td>该笔报销单关联的所有借款单，查看借款单中待核销的金额，是否大于等于待核销的金额值</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>核销总金额验证</td> 
   <td>该笔报销单关联的所有借款单核销记录表明细，核销金额和必须等于核销总金额</td> 
   <td>无</td> 
  </tr> 
 </tbody> 
</table>

##### 风控 #####

<table> 
 <thead> 
  <tr> 
   <th>项目</th> 
   <th>规则</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>额度</td> 
   <td>单笔报销额度在xx万以内。</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>最大关联借款单数</td> 
   <td>本次报销最多关联xx笔借款单。</td> 
   <td>无</td> 
  </tr> 
 </tbody> 
</table>

##### 路由 #####

<table> 
 <thead> 
  <tr> 
   <th>项目</th> 
   <th>规则</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>银企支付</td> 
   <td>调用银行接口，由公司银行账户，转账给申请报销人的银行账号。系统层面记录个人，公司虚拟账户金额变动情况。</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>系统转账</td> 
   <td>财务通过其他途径转账给申请人，系统层面记录个人，公司虚拟账户金额变动情况。</td> 
   <td>无</td> 
  </tr> 
 </tbody> 
</table>

##### 银企支付 #####

转账金额：为报销实际交易金额。  
调用银行对外封装的接口，做转账业务。不同银行的逻辑不同，本文以浦发银行为例。详情参考银企支付设计模块。

##### 业务处理 #####

###### 报销实际交易金额大于零 ######

<table> 
 <thead> 
  <tr> 
   <th>项目</th> 
   <th>规则</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>转入流水金额</td> 
   <td>报销方报销成功，写入的一条个人入账流水到流水表。</td> 
   <td>流水金额为报销实际交易金额</td> 
  </tr> 
  <tr> 
   <td>转出核销流水金额</td> 
   <td>报销方核销成功，写入的一条个人核销出账流水到流水表。</td> 
   <td>流水金额为核销金额</td> 
  </tr> 
  <tr> 
   <td>转出流水金额</td> 
   <td>被报销方处理报销金额，写入一条转出流水到流水表。</td> 
   <td>流水金额为报销实际交易金额</td> 
  </tr> 
  <tr> 
   <td>手续费</td> 
   <td>目前不存在交易手续费</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>转账日志</td> 
   <td>记录转账相关的明细信息。</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>核销日志</td> 
   <td>记录核销相关的明细信息。</td> 
   <td>核销金额大于零才有核销日志</td> 
  </tr> 
  <tr> 
   <td>终态确定</td> 
   <td>最终完善该条报销单据的处理结果。</td> 
   <td>是否核销成功</td> 
  </tr> 
 </tbody> 
</table>

###### 实际报销交易金额等于零 ######

实际报销交易金额等于零，可套用大于零的流程。当实际交易金额为零，不用写报销方和被报销方的转入转出流水。报销方写核销的转出流水。

###### 核销金额等于零 ######

核销金额等于零，可套用大于零的流程。当核销金额为零，写报销方和被报销方的转入转出流水。报销方不写核销的转出流水。核销金额为零，不用关联借款单，不存在核销日志和借款单状态变更。

##### 执行流程日志 #####

流程日志记录单据从开始执行支付业务时，在不同节点的处理过程日志。详情查看流程日志设计模块。

#### 3.2、数据流向说明 ####

### 4、银企互联 ###

#### 4.1、调用流程 ####

本文以浦发银行做银企互联介绍，银企互联，封装银行提供的交易接口，在进行交易操作时，记录交互过程的明细信息。提交的交易请求后，银行的处理结果包括如下三类：

1.  拒绝交易：银行柜员或系统，拒绝或撤销支付请求。该笔交易设置为失败。
2.  交易成功：发起请求的交易操作成功。
3.  交易处理过程中：发起的交易请求，银行还在流程处理中，属于中间状态。  
    ![www.wityx.com][www.wityx.com 2]

银企互联发起交易请求步骤：组织支付网关，调用单笔交易请求接口8801，接收反馈结果。

1.  若反馈结果成功或处理中，调用8804查询接口。
2.  若反馈失败，则先停止业务处理。
3.  由于银行一般不会马上反馈支付成功的结果，一般执行都需要一个时间段，便于银行内部中转，对于这种中转结果，等待银行处理，定时调用8804接口去请求银行，查看发起的支付请求是否处理完成了。接收8804接口反馈的结果，在处理业务。

#### 4.2、数据流向说明 ####

### 5、执行流程日志 ###

#### 5.1、流程日志说明 ####

执行流程主要记录单据在支付过程中，关键节点的执行明细信息。流程日志至记录执行到当前节点时的执行结果，备注信息，请求关键参数。当前节点真正的明细信息，在相关业务表中查询，不记录在日志中。 业务处理要求统一在一个事务中，执行流程日志不放在事务中。及业务处理和日志记录时，执行流程日志记录在缓存中，最终把缓存的数据同步到 [数据库][Link 1]中。

<table> 
 <thead> 
  <tr> 
   <th>项目</th> 
   <th>规则</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>业务受理验证日志</td> 
   <td>当验证都通过时，记录验证结果为通过，并记录请求验证的参数。当验证结果失败时，记录验证失败原因和验证请求参数。</td> 
  </tr> 
  <tr> 
   <td>业务风控验证</td> 
   <td>当验证成功时，记录验证结果和请求验证的参数。验证失败时，记录验证失败原因和验证的请求参数。</td> 
  </tr> 
  <tr> 
   <td>请求原始日志</td> 
   <td>记录原始请求日志是否保存成功。</td> 
  </tr> 
  <tr> 
   <td>调用银行请求报文</td> 
   <td>记录在调用8801时的请求时间，请求参数。</td> 
  </tr> 
  <tr> 
   <td>银行反馈-接收8801反馈信息</td> 
   <td>记录接收反馈信息时，银行返回的信息（成功，银行处理中，失败）。</td> 
  </tr> 
  <tr> 
   <td>银行反馈-接收8804反馈信息</td> 
   <td>记录接收到8804接口反馈时，银行返回的信息（成功，银行处理中，失败）。</td> 
  </tr> 
  <tr> 
   <td>业务请求处理日志</td> 
   <td>记录银企通过，或转账时，发起的业务处理相关的日志信息，包括发起请求参数记录。</td> 
  </tr> 
  <tr> 
   <td>流水变动日志</td> 
   <td>记录流水变动发生的时间，及变动的请求参数，变动处理结果。</td> 
  </tr> 
  <tr> 
   <td>核销流程日志</td> 
   <td>记录核销发生的时间，核销请求的相关参数，核销处理结果。</td> 
  </tr> 
  <tr> 
   <td>单据完成状态</td> 
   <td>记录单据最终的处理结果。</td> 
  </tr> 
 </tbody> 
</table>

### 6、监控 ###

通过执行过程日志，查看支付流程在各个节点的明细信息，便于监控支付在各个节点的流转状态。  
![www.wityx.com][www.wityx.com 3]

<table> 
 <thead> 
  <tr> 
   <th>节点</th> 
   <th>说明</th> 
   <th>相关数据表</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>支付校验</td> 
   <td>记录支付校验结果，失败时，记录失败原因</td> 
   <td>流程日志表<code>pay_life_log</code></td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>风控校验</td> 
   <td>记录风控校验结果，失败时，记录失败原因</td> 
   <td>流程日志表<code>pay_life_log</code></td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>支付请求</td> 
   <td>记录支付原始信息，明细需异步查看支付的日志信息</td> 
   <td>流程日志表<code>pay_life_log</code><br>支付请求表<code>bill_pay_request</code></td> 
   <td>后续支付，业务处理基于支付原始信息做处理</td> 
  </tr> 
  <tr> 
   <td>银行报文</td> 
   <td>记录支付请求信息，明细需异步查看支付的报文</td> 
   <td>流程日志表<code>pay_life_log</code><br>银企支付入参表<code>bank_req_source</code></td> 
   <td>银企支付模式时，才有</td> 
  </tr> 
  <tr> 
   <td>银行支付结果</td> 
   <td>记录支付请求后，银行返回的处理信息，明细日志异步查询</td> 
   <td>流程日志表<code>pay_life_log</code><br>银企接口反馈信息表<code>bank_res_parsing_source</code></td> 
   <td>银企支付模式时，才有</td> 
  </tr> 
  <tr> 
   <td>核销日志结果</td> 
   <td>记录报销单，核销业务处理后的日志信息，明细日志异步查询</td> 
   <td>流程日志表<code>pay_life_log</code><br>核销日志表<code>writed_off_log</code><br>借款单数据表<code>borrowing_bill</code></td> 
   <td>报销单核销金额大于零时，才有</td> 
  </tr> 
  <tr> 
   <td>交易流水结果</td> 
   <td>记录转账/银企处理后，业务处理板块流变更的日志。明细日志异步查询</td> 
   <td>流程日志表<code>pay_life_log</code><br>交易流水日志表<code>caiwu_transfer</code></td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>支付结果</td> 
   <td>记录单据发起支付后，最终的支付处理结果</td> 
   <td>流程日志表<code>pay_life_log</code></td> 
   <td>无</td> 
  </tr> 
 </tbody> 
</table>

### 7、差错处理 ###

通过监控单据的明细信息，可定位单据在不同节点的情况。在单据支付失败时，提供差错处理功能，便于工作人员通过操作界面，手动处理单据。差错处理包括如下模式：

<table> 
 <thead> 
  <tr> 
   <th>节点</th> 
   <th>前置条件</th> 
   <th>后置行为</th> 
   <th>描述</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>重新校验</td> 
   <td>支付校验失败<br>风控校验失败</td> 
   <td>继续走校验后的所有流程</td> 
   <td>若校验不通过，修复数据后，可发起重新校验的操作</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>发起银行支付</td> 
   <td>支付请求表<code>bill_pay_request</code>记录的银行处理结果为失败时<br>银企解析信息表<code>bank_res_pay</code>也为失败时，才可重新发起银行支付请求</td> 
   <td>继续走请求支付后的所有流程</td> 
   <td>为单据重新生成一个银行请求报文编码，更新支付请求表<code>bill_pay_request</code>中的银企包（packet_id）字段</td> 
   <td>避免同一个单据，多次向银行发起交易请求</td> 
  </tr> 
  <tr> 
   <td>发起银行查询</td> 
   <td>支付请求表<code>bill_pay_request</code>记录的银行处理结果为处理中</td> 
   <td>继续走银行反馈信息后的流程</td> 
   <td>调用银行8804查询接口，查询银行处理信息</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>发起业务处理</td> 
   <td>支付模式为转账<br>支付模式为银企时，银企支付处理成功后</td> 
   <td>继续走业务处理流程</td> 
   <td>初次业务处理失败时，再次调用业务处理板块重新处理</td> 
   <td>业务处理流程保证在一个事务下</td> 
  </tr> 
  <tr> 
   <td>更新支付模式-银企支付更新为转账模式</td> 
   <td>支付请求表<code>bill_pay_request</code>记录的银行处理结果为失败时<br>银企解析信息表<code>bank_res_pay</code>也为失败时，才可更新支付模式</td> 
   <td>继续走业务处理流程</td> 
   <td>更新支付请求表<code>bill_pay_request</code>中的支付模式（pay_type）字段</td> 
   <td>避免银企处理成功又变更为转账的情况</td> 
  </tr> 
 </tbody> 
</table>

### 8、数据库设计 ###

数据表每个业务不同，不便于展示数据具体字段。

**借款单数据表`borrowing_bill`**

**核销日志表`writed_off_log`**

**支付请求表`bill_pay_request`**

**银企支付入参表`bank_req_source`**

**银企接口反馈信息表`bank_res_parsing_source`**

**银企解析信息表`bank_res_pay`**

**银企调用异常表`bank_res_error`**

**报销单据表`refund_bill`**

**转账日志表`transfer`**

**交易流水日志表`trade_log`**

**流程日志表`pay_life_log`**

[www.wityx.com]: http://apidoc.epetbar.com/upload/f62a652137739c019d46e798e0fe1931
[www.wityx.com 1]: http://apidoc.epetbar.com/upload/441a8d68e0935e13337f63e7944eb855
[www.wityx.com 2]: http://apidoc.epetbar.com/upload/95c172eebf5d4afc9fdbc3d9c5225882
[Link 1]: http://www.wityx.com/database/
[www.wityx.com 3]: http://apidoc.epetbar.com/upload/04be0a71663e71a0629411a3d1c5b9ca