140 lines
3.7 KiB
Markdown
140 lines
3.7 KiB
Markdown
# 支付配置说明
|
||
|
||
## 支付宝配置
|
||
|
||
### 1. 申请支付宝开放平台应用
|
||
1. 访问 [支付宝开放平台](https://open.alipay.com/)
|
||
2. 注册开发者账号
|
||
3. 创建应用，选择"网页&移动应用"
|
||
4. 获取应用信息：
|
||
- APPID
|
||
- 应用私钥
|
||
- 支付宝公钥
|
||
|
||
### 2. 配置沙箱环境
|
||
1. 在开放平台控制台启用沙箱环境
|
||
2. 获取沙箱应用信息
|
||
3. 下载沙箱版支付宝APP进行测试
|
||
|
||
### 3. 更新配置文件
|
||
在 `application-dev.properties` 中更新以下配置：
|
||
|
||
```properties
|
||
# 支付宝沙箱配置
|
||
alipay.app-id=你的沙箱APPID
|
||
alipay.private-key=你的应用私钥
|
||
alipay.public-key=支付宝公钥
|
||
alipay.gateway-url=https://openapi.alipaydev.com/gateway.do
|
||
alipay.notify-url=http://你的域名:8080/api/payments/alipay/notify
|
||
alipay.return-url=http://你的域名:8080/api/payments/alipay/return
|
||
```
|
||
|
||
## PayPal配置
|
||
|
||
### 1. 申请PayPal开发者账号
|
||
1. 访问 [PayPal开发者中心](https://developer.paypal.com/)
|
||
2. 注册开发者账号
|
||
3. 创建应用，选择"Sandbox"环境
|
||
4. 获取应用信息：
|
||
- Client ID
|
||
- Client Secret
|
||
|
||
### 2. 更新配置文件
|
||
在 `application-dev.properties` 中更新以下配置：
|
||
|
||
```properties
|
||
# PayPal沙箱配置
|
||
paypal.client-id=你的沙箱Client ID
|
||
paypal.client-secret=你的沙箱Client Secret
|
||
paypal.mode=sandbox
|
||
paypal.return-url=http://你的域名:8080/api/payments/paypal/return
|
||
paypal.cancel-url=http://你的域名:8080/api/payments/paypal/cancel
|
||
```
|
||
|
||
## 生产环境配置
|
||
|
||
### 1. 环境变量配置
|
||
生产环境建议使用环境变量：
|
||
|
||
```bash
|
||
# 支付宝生产环境
|
||
export ALIPAY_APP_ID=你的生产APPID
|
||
export ALIPAY_PRIVATE_KEY=你的生产私钥
|
||
export ALIPAY_PUBLIC_KEY=支付宝生产公钥
|
||
export ALIPAY_NOTIFY_URL=https://你的域名/api/payments/alipay/notify
|
||
export ALIPAY_RETURN_URL=https://你的域名/api/payments/alipay/return
|
||
|
||
# PayPal生产环境
|
||
export PAYPAL_CLIENT_ID=你的生产Client ID
|
||
export PAYPAL_CLIENT_SECRET=你的生产Client Secret
|
||
export PAYPAL_RETURN_URL=https://你的域名/api/payments/paypal/return
|
||
export PAYPAL_CANCEL_URL=https://你的域名/api/payments/paypal/cancel
|
||
```
|
||
|
||
### 2. 更新生产环境配置
|
||
在 `application-prod.properties` 中：
|
||
|
||
```properties
|
||
# 支付宝生产环境
|
||
alipay.app-id=${ALIPAY_APP_ID}
|
||
alipay.private-key=${ALIPAY_PRIVATE_KEY}
|
||
alipay.public-key=${ALIPAY_PUBLIC_KEY}
|
||
alipay.gateway-url=https://openapi.alipay.com/gateway.do
|
||
alipay.notify-url=${ALIPAY_NOTIFY_URL}
|
||
alipay.return-url=${ALIPAY_RETURN_URL}
|
||
|
||
# PayPal生产环境
|
||
paypal.client-id=${PAYPAL_CLIENT_ID}
|
||
paypal.client-secret=${PAYPAL_CLIENT_SECRET}
|
||
paypal.mode=live
|
||
paypal.return-url=${PAYPAL_RETURN_URL}
|
||
paypal.cancel-url=${PAYPAL_CANCEL_URL}
|
||
```
|
||
|
||
## 测试支付功能
|
||
|
||
### 1. 启动应用
|
||
```bash
|
||
# 启动后端服务
|
||
mvn spring-boot:run
|
||
|
||
# 启动前端服务
|
||
cd frontend
|
||
npm run dev
|
||
```
|
||
|
||
### 2. 测试流程
|
||
1. 访问 http://localhost:3000
|
||
2. 登录测试账号
|
||
3. 创建订单
|
||
4. 选择支付方式
|
||
5. 完成支付测试
|
||
|
||
### 3. 测试账号
|
||
- **支付宝沙箱**: 使用沙箱版支付宝APP扫码支付
|
||
- **PayPal沙箱**: 使用沙箱测试账号进行支付
|
||
|
||
## 注意事项
|
||
|
||
1. **HTTPS要求**: 生产环境必须使用HTTPS
|
||
2. **域名配置**: 确保回调URL使用正确的域名
|
||
3. **签名验证**: 确保私钥和公钥配置正确
|
||
4. **日志监控**: 监控支付回调日志
|
||
5. **异常处理**: 实现完善的异常处理机制
|
||
|
||
## 常见问题
|
||
|
||
### Q: 支付宝回调失败
|
||
A: 检查notify-url是否正确，确保服务器可以接收POST请求
|
||
|
||
### Q: PayPal支付页面无法打开
|
||
A: 检查Client ID和Secret是否正确，确保使用沙箱模式
|
||
|
||
### Q: 签名验证失败
|
||
A: 检查私钥格式，确保没有多余的空格和换行符
|
||
|
||
### Q: 跨域问题
|
||
A: 确保CORS配置正确，允许支付平台的域名
|
||
|
||
|