蓝兔支付SDK：lantu-pay-sdk

一、项目介绍

支持个人用户签约使用的蓝兔支付平台的Java SDK项目。API接口来源：https://www.ltzf.cn/doc

我的邀请注册链接：https://www.ltzf.cn/?invite=owbryg

蓝兔支付申请教程：https://juejin.cn/post/7312273015873732649

二、项目内容

针对支持个人签约的蓝兔支付平台的提供的Java SDK工具包，SDK设计思想可以参考开源项目wxjava中相关的类设计，抽取了其中的核心设计。通过这个项目你可以学习到：

1、统一抽象的HTTP请求框架的设计与实现

2、多个模板方法模式、策略模式、建造者设计与实现

3、请求三方时的@Require注解校验设计与实现

4、错误重试的设计与实现

5、泛型的设计与实现

6、请求参数的签名的设计与实现

三、工程结构

docs：工程的相关文档

SDK支付的Demo工程：lantu-sdk-demo

SDK的JAVA工程：lantu-sdk-java

Spring Boot Starter工程：lantu-sdk-spring-boot-starter

四、功能列表

1、目前正在develop分支进行开发，定期合并到主分支

2、开发进度如下：

• 20231218：开发Starter：Lantu SDK Spring Starter
• 20231229：开发HTTP请求框架：HTTP请求框架与存储层配置
• 20231231：开发PC端二维码下单接口：PC下单支付请求流程
• 20240102：开发订单退款接口：订单退款API
• 20240103：开发订单查询接口：订单查询API

3、目前实现功能如下：

• PC端扫码支付API(LantuWxPayNativeOrderRequest)
• 订单退款API(LantuWxPayRefundOrderRequest)
• 订单查询API(LantuWxPayQueryOrderRequest)
• 查询微信授权连接API(LantuWxPayGetWechatOpenIdRequest)

五、使用步骤

1、在业务项目工程中，引入maven依赖，目前需要手动导入，后续会上传到maven仓库:

<dependency>
    <groupId>cn.ltzf</groupId>
    <artifactId>lantu-sdk-spring-boot-starter</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

2、在配置文件中，配置需要的商户号、回调地址、秘钥等信息：

ltzf:
  wx:
    mch-id: ""
    secret-key: ""
    notify-url: ""

3、在业务代码中，注入Service类，并定义PC端下单生成接口：

@RestController
@RequestMapping("/demo")
public class DemoController {
    
    /**
    * 注入蓝兔支付Service
    */
    @Autowired
    private LantuWxPayService lantuWxPayService;
    
    /**
     * 测试蓝兔支付 PC端扫描请求
     *
     * @return
     */
    @GetMapping("/native")
    public LantuWxPayNativeOrderResult nativeOrder() {
        // 定义蓝兔支付二维码生成请求
        LantuWxPayNativeOrderRequest request = new LantuWxPayNativeOrderRequest();
        String tradeNo = "2023" + System.currentTimeMillis();
        request.setOutTradeNo(tradeNo);
        request.setTotalFee("0.01");
        request.setBody("测试商品");
        LantuWxPayNativeOrderResult result = lantuWxPayService.createNativeOrder(request);
        return result;
    }
    
}

六、参与贡献

1、工程中采用checkstyle.xml文件作为代码风格的统一与质量检测，在开发时需要导入项目中的该文件进行检测，需要使用maven的validate进行参数的校验

2、fork当前仓库到自己的仓库，然后在develop分支上进行开发，然后提交PR

3、加入知识星球，与作者沟通交流自己的想法

七、知识星球

知识星球：觉醒的新世界程序员