蓝兔支付

基于Java开发的微信支付SDK项目，用于对接蓝兔支付平台（ltzf.cn）的支付接口。下面我来详细介绍这个项目：

项目概述

这个项目是一个Java SDK，专门用于对接蓝兔支付平台的微信支付功能。它封装了与支付平台通信的API，使开发者能够方便地在自己的应用中集成微信支付功能。

项目结构

项目主要分为以下几个模块：

1. 工厂模块（factory）：负责创建和配置支付服务实例

o PayFactory：支付服务工厂接口

o DefaultPayFactory：默认工厂实现

o Configuration：配置类，管理API密钥、商户信息等

2. 支付模块（payments）：支持多种支付方式的具体实现

o nativepay（扫码支付）：生成二维码供用户扫描支付

o h5（H5支付）：在手机浏览器中打开的支付页面

o app（APP支付）：在移动应用内调起微信支付

o jsapi（公众号支付）：在微信公众号内调起支付

o jump_h5（跳转H5支付）：跳转到微信外部浏览器支付

3. 工具模块（utils）：

o SignUtils：签名工具类，用于生成请求签名，确保数据安全

核心功能

每种支付方式都实现了以下核心功能：

1. 预支付（prepay）：创建支付订单，获取支付信息

2. 查询订单（queryOrderByOutTradeNo）：根据商户订单号查询支付状态

3. 退款（refundOrder）：发起退款请求

4. 查询退款（getRefundOrder）：查询退款状态

技术实现

HTTP客户端

项目使用了以下技术栈：

· Retrofit：类型安全的HTTP客户端，用于调用支付平台API

· OkHttpClient：底层HTTP实现，支持连接池、超时配置等

· Jackson：JSON序列化和反序列化

签名机制

为了确保请求的安全性，所有请求都需要进行签名：

public String createSign(String partnerKey) {
    Map<String, String> dataMap = new HashMap<>();
    dataMap.put("mch_id", getMchid());
    dataMap.put("out_trade_no", getOutTradeNo());
    // ... 添加其他参数
    return SignUtils.createSign(dataMap, partnerKey);
}

配置管理

通过Configuration类集中管理配置信息：

Configuration configuration = new Configuration(
    "appId",           // 应用ID
    "merchantId",      // 商户号
    "partnerKey"       // 商户密钥
);

使用示例

以Native支付为例：

// 1. 初始化配置
Configuration configuration = new Configuration(
    "1104268",                    // appId
    "1673424392",                 // merchantId
    "6d3e889f359fcb83d150e9553a9217b9"  // partnerKey
);

// 2. 创建工厂和服务
PayFactory payFactory = new DefaultPayFactory(configuration);
NativePayService nativePayService = payFactory.nativePayService();

// 3. 创建支付请求
PrepayRequest request = new PrepayRequest();
request.setMchid("1673424392");
request.setOutTradeNo(RandomStringUtils.randomNumeric(8));
request.setTotalFee("0.01");
request.setBody("商品描述");
request.setNotifyUrl("https://gaga.plus/");

// 4. 发起支付
PrepayResponse response = nativePayService.prepay(request);