vn_pay_demo/QUICK_START.md

快速开始指南 - VnPay Demo

🚀 5分钟快速启动

Windows用户

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

Mac/Linux用户

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测试

# 测试服务状态
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

---

祝测试顺利！🎉