商家转账到零钱 Demo

简介

商家转账到零钱为商户提供向一个或者同时向多个用户微信零钱转账的能力，本项目是为便于商户和开发者快速理解业务、降低接入门槛而开发的演示Demo，运行后界面如下：

通过该Demo你可以：

1）直观地了解商家转账功能；
2）参考演示Demo的界面设计，帮助商户的产品人员设计商家转账功能；
3）参考Demo的源码实现，帮助商户的研发人员实现商家转账功能；

该Demo覆盖的APIv3接口：

1）发起商家转账；
2）通过商家批次单号查询批次单；
3）通过商家明细单号查询明细单；

运行环境

• java 17.0.5 2022-10-18 LTS
• gradle-8.0

使用入门

1、下载代码

git clone https://github.com/wujunjiesd/transferbatch-demo-java.git

2、创建.env文件

cd transferbatch-demo-java
cp .env.example .env

3、完善.env内容

打开.env文件，按照注释说明填写配置信息。

4、运行项目

gradle bootRun

5、体验Demo

在浏览器输入：http://localhost:8080/create.html

常见问题

Demo是否可以直接应用于生产环境？

不可以。例如为了便于快速部署而选用了SQLite作为存储、缺少鉴权相关逻辑。开发者可以参考Demo实现，并根据项目实际情况进行修改。

发起商家转账返回失败或超时，我应该如何处理？

应该查单确认转账单状态。返回失败或超时并不表示转账失败，只有查单后确认该笔转账单处于终态且明确失败的情况下才可以更换单号重新发起转账，在转账单状态不明确的情况下可以原单号重试。未经过查单确认就更换单号重新转账可能导致资金损失。

什么情况需要传入收款人姓名？

当明细转账金额超过2000元时，发起批量转账时需传入加密后的用户姓名。用户姓名属于敏感信息，受到合规限制，商户应将其加密后存储在数据库中。

商户私钥等敏感信息怎么托管？

为了便于Demo快速部署该项目直接将敏感信息配置在.env文件中，但我们推荐敏感信息加密后配置在.env文件中，在代码中解密使用，密文和解密的密钥不要放在一起，注意不要将.env文件提交到代码仓库。

发起转账后，在什么时机查询转账单状态？

该Demo是通过前端界面触发通过商家批次单号查询批次单操作从而更新存储中的转账单状态，商户可以结合自己的实际情况，针对状态不明确的转账单通过定时任务触发查询操作。