09_充值/提现

本文详细描述了在IT技术背景下,银行存管系统中的充值和提现业务流程,包括用户操作、数据生成、请求处理和结果通知的接口定义。重点介绍了如何通过接口在用户中心、存管代理和服务间传递和验证充值和提现数据。
摘要由CSDN通过智能技术生成

充值

1 充值业务概述

用户在平台开户后会在银行存管系统中有一个虚拟银行账号,用户通过万信金融把储蓄卡中的金额转入到银行存管系统的虚拟银行账户中,即为充值。就好比你把银行卡中的金额转入到支付宝或微信中是一个道理。投资人在投标前需要先充值。

在这里插入图片描述

充值流程如下:

在这里插入图片描述

  1. 用户在’我的’页面点击’账户余额’
  2. 点击充值(如果用户尚未开户,会被自动跳转到开户界面),填写充值金额
  3. 确认信息并输入开户时设置的交易密码
  4. 充值成功

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-1.7)”,熟悉该阶段的具体需求和业务流程
  2. 查阅银行存管系统接口说明.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 提现业务概述

​ 提现指的是:投资人在收到借款人的还款后,将余额从银行存管系统的虚拟账户中提取到自己绑定的储蓄卡。业务流程如下所示:

在这里插入图片描述

  1. 用户在’我的’页面点击’账户余额’
  2. 点击提现,填写提现金额
  3. 确认提现信息并输入开户时设置的交易密码
  4. 提现成功

2 用户提现

2.1 需求分析

在这里插入图片描述

第一阶段:生成请求数据(图中1.1-1.7)

  1. 前端填写提现信息

  2. 前端请求用户中心服务提现

  3. 用户中心服务准备提现数据

  4. 用户中心服务请求存管代理服务生成交易记录(未同步),并对提现数据进行签名

  5. 存管代理服务将签名后的提现数据返回给用户中心

  6. 用户中心将提现数据返回给前端

第二阶段:请求提现(图中2.1-2.8)

  1. 前端携带提现信息请求银行存管系统

  2. 银行存管系统向前端返回提现信息确定页面

  3. 前端确认完成提交提现请求到银行存管系统

  4. 银行存管系统接收提现数据并进行校验,校验交易密码,无误后则将银行卡余额进行扣减

第三阶段:提现结果通知(图中3.1-3.4)

  1. 提现成功后银行存管系统异步通知存管代理服务

  2. 存管代理服务接收到提现成功通知更新交易状态为同步

  3. 存管代理服务通知用户中心服务

  4. 用户中心服务接收到提现成功的消息保存提现信息到用户中心服务

2.2 第一阶段:生成提现数据

  1. 参考前面的“提现业务流程图(图中1.1-1.7)”,熟悉该阶段的具体需求和业务流程
  2. 查阅银行存管系统接口说明.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类,把其中两行代码的注释去掉,如下图所示:

在这里插入图片描述

  • 25
    点赞
  • 26
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

我是二次元穿越来的

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值