# 快速开始指南 - VnPay Demo

## 🚀 5分钟快速启动

### Windows用户

1. **双击运行 `start.bat`**
   - 自动检查环境
   - 自动编译项目
   - 自动启动服务

### Mac/Linux用户

```bash
chmod +x start.sh
./start.sh
```

## 📝 快速测试

### 1. 验证服务状态

打开浏览器访问：http://localhost:8080

你应该能看到项目的API文档页面。

### 2. 使用Postman测试

#### 方法一：导入Postman集合

1. 打开Postman
2. 点击 Import
3. 选择文件 `VnPay-Demo.postman_collection.json`
4. 运行测试

#### 方法二：手动测试

**测试服务状态：**
```
GET http://localhost:8080/demo/test
```

**测试支付接口：**
```
POST http://localhost:8080/demo/apiPay
Content-Type: application/x-www-form-urlencoded

tradeType=SCAN_PAY&version=1.0&channel=ALI_PAY&mchNo=M1234567890&mchOrderNo=ORDER20240130001&body=测试商品&amount=10000&currency=VND&timePaid=20240130120000&notifyUrl=http://localhost:8080/demo/notify/getPayInfo&paySecret=bf183091a6654c339b7b452a996c4ce5
```

### 3. 使用cURL测试

```bash
# 测试服务状态
curl http://localhost:8080/demo/test

# 测试支付接口
curl -X POST http://localhost:8080/demo/apiPay \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "tradeType=SCAN_PAY&version=1.0&channel=ALI_PAY&mchNo=M1234567890&mchOrderNo=ORDER$(date +%s)&body=测试商品&amount=10000&currency=VND&timePaid=$(date +%Y%m%d%H%M%S)&notifyUrl=http://localhost:8080/demo/notify/getPayInfo&paySecret=bf183091a6654c339b7b452a996c4ce5"
```

## 🎯 关键测试点

1. **签名验证** - 确保请求包含正确的签名
2. **订单号唯一性** - 每次测试使用不同的订单号
3. **异步通知** - 确保notifyUrl可访问
4. **金额单位** - 注意金额单位是分，不是元

## 🔧 常见问题

### 端口被占用？

修改 `application.properties` 中的 `server.port=8080` 为其他端口。

### 编译失败？

检查：
- JDK版本是否为1.8+
- Maven是否正确安装
- 网络是否能访问Maven仓库

### 签名错误？

1. 查看控制台日志中的"签名前字符串"
2. 确认参数排序正确
3. 确认paySecret密钥正确

## 📞 需要帮助？

1. 查看控制台日志
2. 访问 http://localhost:8080 查看API文档
3. 查看项目中的API文档：
   - `Api-V1.8.13 (19) (2).docx`
   - `Api-V1.8.13EN.docx`

---

祝测试顺利！🎉