充值
1 充值业务概述
用户在平台开户后会在银行存管系统中有一个虚拟银行账号,用户通过万信金融把储蓄卡中的金额转入到银行存管系统的虚拟银行账户中,即为充值。就好比你把银行卡中的金额转入到支付宝或微信中是一个道理。投资人在投标前需要先充值。
充值流程如下:
- 用户在’我的’页面点击’账户余额’
- 点击充值(如果用户尚未开户,会被自动跳转到开户界面),填写充值金额
- 确认信息并输入开户时设置的交易密码
- 充值成功
2 用户充值
2.1 需求分析
第一阶段:生成充值数据(图中1.1-1.7)
1、前端填写充值信息(如果用户尚未开户,会被自动跳转到开户界面)
2、前端请求用户中心服务充值
3、用户中心服务准备充值数据
4、用户中心服务请求存管代理服务生成交易记录(未同步),并对充值数据进行签名
5、存管代理服务将签名后的充值数据返回给用户中心
6、用户中心将充值数据返回给前端
第二阶段:请求充值(图中2.1-2.8)
7、前端携带充值信息请求银行存管系统
8、银行存管系统向前端返回充值信息确定页面
9、前端确认完成提交充值请求到银行存管系统
10、银行存管系统接收充值数据并进行校验,校验交易密码,无误后则将银行卡余额进行扣减
第三阶段:充值结果通知(图中3.1-3.4)
11、充值成功后银行存管系统异步通知存管代理服务
12、存管代理服务接收到充值成功通知更新交易状态为同步
13、存管代理服务通知用户中心服务
14、用户中心服务接收到充值成功的消息后保存充值信息
2.2 第一阶段:生成充值数据
2.2.1 需求分析
- 参考前面的“充值业务流程图(图中1.1-1.7)”,熟悉该阶段的具体需求和业务流程
- 查阅银行存管系统接口说明.pdf中的“充值”接口说明,熟悉接口接收参数和返回值
2.2.2 接口定义
2.2.2.1 用户中心生成充值数据接口(接口①)
在用户中心定义生成充值数据接口:
1、接口描述
1)接收用户填写的充值数据
2)用户中心保存充值信息
3)请求存管代理生成签名数据
4)将签名数据返回给前端
2、接口定义
在ConsumerApi接口中新增createRechargeRecord方法:
/**
* 生成充值请求数据
* @param amount 充值金额
* @param callbackURL 回调地址
* @return
*/
RestResponse<GatewayRequest> createRechargeRecord(String amount, String callbackURL);
在ConsumerController类中实现该方法:
@Override
@ApiOperation("生成充值请求数据")
@ApiImplicitParams({
@ApiImplicitParam(name = "amount", value = "金额", required = true,
dataType = "String", paramType = "query"),
@ApiImplicitParam(name = "callbackURL", value = "通知结果回调Url", required = true,
dataType = "String", paramType = "query")})
@GetMapping("/my/recharge-records")
public RestResponse<GatewayRequest> createRechargeRecord(@RequestParam String amount,
@RequestParam String callbackUrl){
return null;
}
2.2.2.2 存管代理生成充值数据接口(接口②)
在存管代理服务创建生成充值数据接口:
1、接口描述
1)接收用户中心发来的充值请求数据
2)保存交易记录
3)生成签名数据
2、接口定义
在DepositoryAgentApi接口中新增createRechargeRecord方法:
/**
* 用户充值
* @param rechargeRequest
* @return
*/
RestResponse<GatewayRequest> createRechargeRecord(RechargeRequest rechargeRequest);
在DepositoryAgentController类中实现该方法:
@Override
@ApiOperation("生成充值请求数据")
@ApiImplicitParam(name = "rechargeRequest", value = "充值信息", required = true,
dataType = "RechargeRequest", paramType = "body")
@PostMapping("/l/recharges")
public RestResponse<GatewayRequest> createRechargeRecord(@RequestBody RechargeRequest rechargeRequest){
return null;
}
该阶段涉及到的新的类有:RechargeRequest、RechargeRecord
2.3 第二阶段:请求充值
参考前面的“充值业务流程图(图中2.1-2.8)”,该阶段涉及到前端和银行存管系统,这些都不需要我们开发,直接进行测试即可
2.4 第三阶段:充值结果通知
2.4.1 需求分析
参考前面的“充值业务流程图(图中3.1-3.4)”,熟悉该阶段的具体需求和业务流程
2.4.2 接口定义
2.4.2.1 存管代理服务接收通知接口(接口③)
银行存管系统充值成功会通知P2P存管代理服务,该服务需要更新交易状态。
1、接口描述
1)接收银行存管系统通知
2)更新交易状态
3)向用户中心服务通知:向消息队列发送消息
2、接口定义
在DepositoryNotifyController类中新增receiveDepositoryRechargeResult方法:
@ApiOperation("接受银行存管系统充值返回结果")
@ApiImplicitParams({
@ApiImplicitParam(name = "serviceName", value = "请求的银行存管接口名",
required = true, dataType = "String", paramType = "query"),
@ApiImplicitParam(name = "platformNo", value = "平台编号,平台与存管系统签约时获取",
required = true, dataType = "String", paramType = "query"),
@ApiImplicitParam(name = "signature", value = "对reqData参数的签名",
required = true, dataType = "String", paramType = "query"),
@ApiImplicitParam(name = "reqData", value = "业务数据报文,json格式",
required = true, dataType = "String", paramType = "query"),})
@RequestMapping(value = "/gateway", method = RequestMethod.GET,
params = "serviceName=RECHARGE")
public String receiveDepositoryRechargeResult(
@RequestParam("serviceName") String serviceName,
@RequestParam("platformNo") String platformNo,
@RequestParam("signature") String signature,
@RequestParam("reqData") String reqData){
return "OK";
}
2.4.2.2 用户中心服务接收通知接口(接口④)
银行存管系统充值成功会通知存管代理服务,存管代理服务会通知用户中心服务,用户中心收到通知后需要保存充值记录,并更新余额。这里并不是严格意义上的接口,而是一个消息消费者(GatewayNotifyConsumer.java),在开户时已经使用过,参考之前代码实现接收存管代理服务发来的通知,并更新数据。
注意:在对该阶段进行功能测试时,需要在银行存管系统中找到RechargeDetailsServiceImpl类,把其中两行代码的注释去掉,如下图所示:
提现
1 提现业务概述
提现指的是:投资人在收到借款人的还款后,将余额从银行存管系统的虚拟账户中提取到自己绑定的储蓄卡。业务流程如下所示:
- 用户在’我的’页面点击’账户余额’
- 点击提现,填写提现金额
- 确认提现信息并输入开户时设置的交易密码
- 提现成功
2 用户提现
2.1 需求分析
第一阶段:生成请求数据(图中1.1-1.7)
-
前端填写提现信息
-
前端请求用户中心服务提现
-
用户中心服务准备提现数据
-
用户中心服务请求存管代理服务生成交易记录(未同步),并对提现数据进行签名
-
存管代理服务将签名后的提现数据返回给用户中心
-
用户中心将提现数据返回给前端
第二阶段:请求提现(图中2.1-2.8)
-
前端携带提现信息请求银行存管系统
-
银行存管系统向前端返回提现信息确定页面
-
前端确认完成提交提现请求到银行存管系统
-
银行存管系统接收提现数据并进行校验,校验交易密码,无误后则将银行卡余额进行扣减
第三阶段:提现结果通知(图中3.1-3.4)
-
提现成功后银行存管系统异步通知存管代理服务
-
存管代理服务接收到提现成功通知更新交易状态为同步
-
存管代理服务通知用户中心服务
-
用户中心服务接收到提现成功的消息保存提现信息到用户中心服务
2.2 第一阶段:生成提现数据
- 参考前面的“提现业务流程图(图中1.1-1.7)”,熟悉该阶段的具体需求和业务流程
- 查阅银行存管系统接口说明.pdf中的“提现”接口说明,熟悉接口接收参数和返回值
2.2.1 接口定义
2.2.1.1 用户中心生成提现数据接口(接口①)
在用户中心定义生成提现数据接口:
1、接口描述
1)接收用户填写的提现数据
2)用户中心保存提现信息
3)请求存管代理生成签名数据
4)将签名数据返回给前端
2、接口定义
在ConsumerApi接口中新增createWithdrawRecord方法:
/**
* 生成用户提现数据
* @param amount 提现金额
* @param callbackUrl 回调地址
* @return
*/
RestResponse<GatewayRequest> createWithdrawRecord(String amount, String callbackUrl);
在ConsumerController类中实现该方法:
@Override
@ApiOperation("生成用户提现数据")
@ApiImplicitParams({
@ApiImplicitParam(name = "amount", value = "金额", required = true,
dataType = "String", paramType = "query"),
@ApiImplicitParam(name = "callbackUrl", value = "通知结果回调Url", required = true,
dataType = "String", paramType = "query")})
@GetMapping("/my/withdraw-records")
public RestResponse<GatewayRequest> createWithdrawRecord(@RequestParamString amount, @RequestParamString callbackUrl){
return null;
}
2.2.1.2 存管代理生成提现数据接口(接口②)
在存管代理服务创建生成提现数据接口:
1、接口描述
1)接受用户中心发来的提现请求数据
2)保存请求记录
3)生成签名数据
2、接口定义
在DepositoryAgentApi接口中新增createWithdrawRecord方法:
/**
* 用户提现
* @param withdrawRequest
* @return
*/
RestResponse<GatewayRequest> createWithdrawRecord(WithdrawRequest withdrawRequest);
在DepositoryAgentController类中实现该方法:
@Override
@ApiOperation("生成提现请求数据")
@ApiImplicitParam(name = "withdrawRequest", value = "提现信息", required = true,
dataType = "WithdrawRequest", paramType = "body")
@PostMapping("/l/withdraw")
public RestResponse<GatewayRequest> createWithdrawRecord(
@RequestBody WithdrawRequest withdrawRequest){
return null;
}
该阶段涉及到的新的类有:WithdrawRequest、WithdrawRecord
2.3 第二阶段:请求提现
参考前面的“提现业务流程图(图中2.1-2.8)”,该阶段涉及到前端和银行存管系统,这些都不需要我们开发,直接进行测试即可
2.4 第三阶段:提现结果通知
2.4.1 需求分析
参考前面的“提现业务流程图(图中3.1-3.4)”,熟悉该阶段的具体需求和业务流程
2.4.2 接口定义
2.4.2.1 存管代理服务接收通知接口(接口③)
银行存管系统提现成功会通知存管代理服务,该服务要更新数据。
1、接口描述
1)接收银行存管系统通知
2)更新交易状态
3)向用户中心服务通知:向消息队列发送消息
2、接口定义
在DepositoryNotifyController类中新增receiveDepositoryWithdrawResult方法:
@ApiOperation("接受银行存管系统提现返回结果")
@ApiImplicitParams({
@ApiImplicitParam(name = "serviceName", value = "请求的存管接口名",
required = true, dataType = "String", paramType = "query"),
@ApiImplicitParam(name = "platformNo", value = "平台编号,平台与存管系统签约时获取",
required = true, dataType = "String", paramType = "query"),
@ApiImplicitParam(name = "signature", value = "对reqData参数的签名",
required = true, dataType = "String", paramType = "query"),
@ApiImplicitParam(name = "reqData", value = "业务数据报文,json格式",
required = true, dataType = "String", paramType = "query"),})
@RequestMapping(value = "/gateway", method = RequestMethod.GET, params = "serviceName=WITHDRAW")
public String receiveDepositoryWithdrawResult(
@RequestParam("serviceName") String serviceName,
@RequestParam("platformNo") String platformNo,
@RequestParam("signature") String signature,
@RequestParam("reqData") String reqData){
return "OK";
}
2.4.2.2 用户中心服务接收通知接口(接口④)
银行存管系统提现成功会通知存管代理服务,存管代理服务会通知用户中心服务,用户中心收到通知后需要保存提现记录,并更新余额。这里并不是严格意义上的接口,而是一个消息消费者(GatewayNotifyConsumer.java),在开户时已经使用过,参考之前代码实现接收存管代理服务发来的通知,并更新数据。
注意:在对该阶段进行功能测试时,需要在银行存管系统中找到WithdrawDetailsServiceImpl类,把其中两行代码的注释去掉,如下图所示: