# 支付功能快速开始指南

## 5分钟快速配置

### 第1步：配置环境变量（.env）

```env
# 支付宝配置
ALIPAY_APP_ID=2021000000000000
ALIPAY_MERCHANT_PRIVATE_KEY=-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----
ALIPAY_PUBLIC_KEY=-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----
ALIPAY_NOTIFY_URL=https://yourdomain.com/api/order/alipay-notify
ALIPAY_RETURN_URL=https://yourdomain.com/order
ALIPAY_GATEWAY_URL=https://openapi.alipay.com/gateway.do

# 微信支付配置
WECHAT_APP_ID=wx1234567890abcdef
WECHAT_MCH_ID=1234567890
WECHAT_API_KEY=abcdefghijklmnopqrstuvwxyz123456
WECHAT_NOTIFY_URL=https://yourdomain.com/api/order/wechat-notify
WECHAT_GATEWAY_URL=https://api.mch.weixin.qq.com
```

### 第2步：执行数据库迁移

```sql
ALTER TABLE `la_order` ADD COLUMN `trade_no` varchar(100) DEFAULT NULL COMMENT '第三方交易号' AFTER `payment_time`;
```

### 第3步：测试支付流程

1. 打开订单列表
2. 点击"支付"按钮
3. 选择支付方式（支付宝或微信）
4. 点击"确认支付"
5. 跳转到支付页面或显示二维码

## 使用沙箱环境测试

### 支付宝沙箱测试

1. 修改 `.env` 中的网关地址：
```env
ALIPAY_GATEWAY_URL=https://openapi.alipaydev.com/gateway.do
```

2. 使用沙箱账号登录支付宝进行测试

### 微信支付沙箱测试

1. 微信支付已提供沙箱环境
2. 使用测试商户号和 API Key
3. 在微信支付后台配置沙箱账号

## 支付流程说明

### 正常支付
```
订单列表 → 点击支付 → 选择支付方式 → 确认支付 → 跳转支付页面 → 完成支付
```

### 补单支付
```
订单列表 → 点击支付 → 选择补单支付 → 输入订单号 → 选择支付方式 → 确认支付 → 完成支付
```

## 常见问题

### Q: 支付后订单状态没有更新？
A: 检查回调地址是否正确配置，检查防火墙是否允许回调。

### Q: 签名验证失败？
A: 检查密钥是否正确，检查参数排序是否正确。

### Q: 如何查看支付日志？
A: 检查 `runtime/log` 目录下的日志文件。

## 文件位置

- 配置文件：`server/config/pay.php`
- 支付逻辑：`server/app/adminapi/logic/order/OrderLogic.php`
- 支付接口：`server/app/adminapi/controller/order/OrderController.php`
- 回调处理：`server/app/adminapi/controller/order/AlipayNotifyController.php`
- 回调处理：`server/app/adminapi/controller/order/WechatNotifyController.php`
- 前端支付：`admin/src/views/order/index.vue`

## 获取密钥

### 支付宝
1. 登录 https://open.alipay.com/
2. 进入"开发者中心" → "应用管理"
3. 创建应用或选择已有应用
4. 在"开发设置"中生成密钥对

### 微信
1. 登录 https://pay.weixin.qq.com/
2. 进入"账户中心" → "API安全"
3. 获取商户号和 API Key

## 下一步

- 阅读 `PAYMENT_GATEWAY_INTEGRATION.md` 了解详细配置
- 阅读 `PAYMENT_IMPLEMENTATION_SUMMARY.md` 了解实现细节
- 在沙箱环境中测试支付流程
- 部署到生产环境