# 4 财务控制器

## 4.1 会员复销池余额流水

用于获取会员复销池余额流水

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/finance/reconsume-pool-flow|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|无|

### 响应参数list
|参数|类型|描述|
|:---|:---|:---|
|DEAL_TYPE_NAME|string|交易类型|
|DEDUCT_PV|string|交易额|
|CREATED_AT|string|操作时间|


## 4.2 转账流水

用于获取转账流水

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/finance/transfer-list|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|page|int|否| |页码|1|
|pageSize|int|否| |分页长度|10|


### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|showFee|bool|是否显示手续费/实际入账金额|

### 响应参数list
|参数|类型|描述|
|:---|:---|:---|
|OUT_WALLET_NAME|string|转出账户名称|
|LAST_IN_USER_NAME|string|接收会员编号|
|LAST_IN_REAL_NAME|string|接收会员姓名|
|IN_WALLET_NAM|string|转入账户名称|
|ORI_AMOUNT|string|转账金额|
|FEE|string|手续费|
|AMOUNT|string|实际入账金额|
|CREATED_AT|string|转账时间|
|REMARK|string|备注|


## 4.3 转账资格检查

用于转账资格检查

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/finance/chk-transfer-user|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|无|

### 响应参数userInfo
|参数|类型|描述|
|:---|:---|:---|
|ALLOW_TRANSFER|string|允许转账|
|TRANSFER_PROP|string|转账比例|

### 响应参数transferConfig
|参数|类型|描述|
|:---|:---|:---|
|typeId|string|允许转账类型的id|
|fee|string|类型对应手续费|
|outName|string|类型转出账户|
|inName|string|类型转入账户|

## 4.4 获取可用余额

用于获取可用余额

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/finance/available-balance|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|无|

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|-|string|金额|


## 4.5 转账操作

用于转账操作

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|POST|/finance/transfer-add|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|type|int|是|1|类型|1奖金转现金2奖金转奖金|
|toUserName|int|是| |转入会员编号||
|toRealName|int|是| |转入会员姓名||
|amount|string|是| |转账金额||
|payPassword|string|是| |密码||
|remark|string|否| |备注||

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|message|string|转账成功|


## 4.6 提现流水

用于获取提现流水

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/finance/withdraw|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|page|int|否| |页码|1|
|pageSize|int|否| |分页长度|10|
|yearMonth|int|否| |年月|201905|

### 响应参数list
|参数|类型|描述|
|:---|:---|:---|
|AMOUNT|string|奖金|
|AUDIT_STATUS|string|提现状态|
|CREATED_AT|string|创建时间|
|ID|string|提现ID|
|INVOICE_AMOUNT|string|发票金额|
|INVOICE_AUDIT_STATUS|string|发票状态|
|INVOICE_ID|string|发票ID|
|INVOICE_STATUS_NAME|string|发票状态名称|
|IS_AUTO_WITHDRAW|string|是否自动提现|
|PAID_AT|string|付款时间|
|PAID_FAIL_REMARK|string|付款失败备注|
|PAY_TYPE|string|付款类型1见票付款0无票付款|
|REAL_NAME|string|会员姓名|
|STATUS_NAME|string|提现状态名称|
|UPLOAD_ID|string|上传ID|
|USER_ID|string|会员ID|
|USER_NAME|string|会员编号|


## 4.7 提现资格检查

用于提现资格检查

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/finance/chk-withdraw-user|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|无|

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|userInfo|string|用户信息，IS_AUTO_WITHDRAW是否自动提现，IS_BIND是否点位绑定，IS_BIND_MAIN是否主点位，REG_TYPE注册类型，WITHDRAW_PROP，提现比例|
|content|string|注册协议|
|isPact|string|是否显示注册协议|


## 4.8 归集附属会员奖金

用于归集附属会员奖金

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/finance/collect-bind|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|无|

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|message|string|归集完成，归集金额XXX|


## 4.9 提现操作
                              
用于提现操作

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|POST|/finance/withdraw-add|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|applyAmount|string|是| |提现金额||
|payPassword|string|是| |密码||

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|message|string|提现申请已提交，请等待审核|


## 4.10 提现退回

用于提现退回

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|POST|/finance/withdraw-back|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|id|string|是| |提现ID||
|createRemark|string|否| |提现退回备注||

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|message|string|提现已退回|


## 4.11 发票上传前

用于发票上传前

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/finance/invoice-before-add|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|id|string|是|32|提现ID| |

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|addInvoiceTips|string|上传发票提示|


## 4.12 发票上传

用于发票上传

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET,POST,PUT|/finance/invoice-add|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|id|string|是|32|提现ID| |
|uploadToken|string|是|32|提现ID| |
|file||是||文件| |


### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|addInvoiceTips|string|上传成功|


## 4.13 发票显示

用于发票显示

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/finance/invoice-show|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|id|string|是|32|上传ID| |

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|data|string|//图片网址|

## 4.14 充值操作

用于充值操作

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|POST|/finance/recharge-add|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|applyAmount|string|是| |充值金额||
|openBank|string|是| |汇款银行||
|bankNo|string|是| |汇款账号||
|bankAddress|string|是| |银行支行||
|bankProvince|string|是| |银行省||
|bankCity|string|是| |银行市||
|bankCounty|string|是| |银行区县||

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|message|string|充值申请已提交，请等待审核|

## 4.15 充值流水

用于获取充值流水

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/finance/recharge|

### 响应参数list
|参数|类型|描述|
|:---|:---|:---|
|AMOUNT|string|充值金额|
|AUDIT_STATUS|string|充值状态|
|CREATED_AT|string|创建时间|
|ID|string|充值ID|
|REAL_NAME|string|会员姓名|
|STATUS_NAME|string|充值状态名称|
|USER_ID|string|会员ID|
|USER_NAME|string|会员编号|

## 4.16 充值凭证上传

用于充值凭证上传

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET,POST|/finance/prove-add|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|id|string|是|32|充值ID| |
|uploadToken|string|是|32|token| |
|file||是||凭证| |


### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|message|string|上传成功|