# pay

**Repository Path**: wangwang_admin/pay

## Basic Information

- **Project Name**: pay
- **Description**: 这是一个简单易用的Spring Boot支付集成启动器，支持微信支付和支付宝支付
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-05-27
- **Last Updated**: 2026-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Easy Pay Spring Boot Starter

这是一个简单易用的Spring Boot支付集成启动器，支持微信支付和支付宝支付。

## 特性

- 支持支付宝PC网页支付
- 支持微信扫码支付
- 支持订单查询
- 支持退款操作
- 自动配置，使用简单

## 快速开始

### 1. 添加依赖

在你的项目的`pom.xml`中添加以下依赖：

```xml
<dependency>
    <groupId>com.example</groupId>
    <artifactId>easy-pay-spring-boot-starter</artifactId>
    <version>1.0.0</version>
</dependency>
```

### 2. 配置支付参数

在`application.yml`中添加配置：

```yaml
easy:
  pay:
    alipay:
      app-id: your-alipay-app-id
      private-key: your-alipay-private-key
      public-key: alipay-public-key
      notify-url: http://your-domain/pay/alipay/notify
      return-url: http://your-domain/pay/alipay/return
    wxpay:
      app-id: your-wxpay-app-id
      mch-id: your-wxpay-mch-id
      mch-key: your-wxpay-mch-key
      notify-url: http://your-domain/pay/wxpay/notify
      cert-path: /path/to/wxpay/cert.p12  # 如需退款功能则必填
```

### 3. 使用示例

```java
@RestController
@RequestMapping("/pay")
@RequiredArgsConstructor
public class PayController {
    private final AlipayService alipayService;
    private final WxPayService wxPayService;

    // 支付宝支付
    @GetMapping("/alipay/create")
    public String createAlipayOrder() throws AlipayApiException {
        return alipayService.createPayPage(
            "ORDER_123456",  // 商户订单号
            "99.99",        // 订单金额
            "测试商品"      // 商品描述
        );
    }

    // 微信支付
    @GetMapping("/wxpay/create")
    public Map<String, String> createWxPayOrder() throws Exception {
        return wxPayService.createOrder(
            "ORDER_123456",  // 商户订单号
            "9999",         // 订单金额（分）
            "测试商品",     // 商品描述
            "127.0.0.1"    // 终端IP
        );
    }
}
```

## 注意事项

1. 所有金额单位：
   - 支付宝：元，如 "99.99"
   - 微信支付：分，如 "9999"

2. 配置文件中的密钥等敏感信息建议使用配置中心或加密配置

3. 正式环境请确保回调地址(notify-url)可以被支付平台访问

## 常见问题

1. 沙箱环境配置
   - 支付宝：修改 serverUrl 为沙箱环境地址
   - 微信支付：设置 useSandbox: true

2. 证书问题
   - 微信支付退款等接口需要证书，请确保证书路径配置正确

## 许可证

MIT