支付配置

一、支付开关

后台 → 系统设置 → 支付设置：

| 开关 | 说明 | |---|---| | 启用在线支付 | 总开关 | | 启用微信支付 | | | 启用支付宝 | | | 沙箱/测试模式 | 测试用，不真扣款 |

二、微信支付

1. 准备材料

• 微信商户号（MchID）
• 关联的公众号/小程序 AppID
• API 密钥（V2）或 APIv3 密钥
• 商户证书（apiclient_cert.pem / apiclient_key.pem）

2. 配置

后台 → 系统设置 → 支付设置 → 微信支付：

| 字段 | 填什么 | |---|---| | 商户号 | MchID | | AppID | 公众号 AppID | | API 密钥 | 商户后台设置的 API 密钥 | | 证书路径 | 上传证书到 storage/certs/ | | 回调地址 | https://你的域名/pay/notify/wechat |

3. 回调地址

在微信商户平台 → 产品中心 → 开发配置 → 支付回调 URL：

https://你的域名/pay/notify/wechat

三、支付宝

1. 准备材料

• 支付宝应用 AppID
• 应用私钥
• 支付宝公钥

2. 配置

后台 → 系统设置 → 支付设置 → 支付宝：

| 字段 | 填什么 | |---|---| | AppID | 应用 ID | | 应用私钥 | 从密钥工具生成 | | 支付宝公钥 | 支付宝后台下载 | | 回调地址 | https://你的域名/pay/notify/alipay |

四、测试支付

用测试模式（沙箱）跑一遍：

1. 开启「测试模式」
2. 前台下一笔会费
3. 用测试账号支付
4. 确认：订单状态变「已支付」+ 会费自动登记 + 财务自动记账

测试完记得关掉测试模式。

五、支付对账

后台 → 财务 → 对账中心：

• 收入/退款/手续费/净额
• 和微信/支付宝后台对账
• 差异明细

系统每 5 分钟自动对账一次（pay:reconcile）。

六、退款

后台 → 财务 → 退款：

1. 找到订单
2. 点退款
3. 填金额（可部分退）
4. 提交后自动调支付平台退款

退款会自动记一笔「退款支出」，并扣回手续费（按配置）。

七、常见问题

| 问题 | 排查 | |---|---| | 支付后订单没变已支付 | 回调地址不通；检查 pay/notify 是否 200 | | 金额对不上 | 系统金额单位是分，别当元 | | 退款失败 | 证书/密钥错误，或余额不足 | | 手续费算错 | 财务设置里的费率 |

下一篇：公众号配置