支付管理
支付管理模块用于配置和管理平台的支付方式，包括微信支付、支付宝支付等。
功能概述
支付管理包含以下功能：
- 支付配置：配置各支付方式的参数
- 支付记录：查看支付流水记录
- 退款管理：处理退款申请
- 支付统计：查看支付数据统计
支付方式
系统支持以下支付方式：
| 支付方式 | 适用场景 | 到账时间 |
|---|---|---|
| 微信支付 | 微信小程序、H5、APP | 实时 |
| 支付宝 | H5、APP | 实时 |
| 余额支付 | 全平台 | 实时 |
| 模拟支付 | 测试环境 | 实时 |
微信支付配置
配置前准备
配置微信支付前，需要准备以下资料：
- 微信支付商户号（mch_id）
- 小程序/公众号 AppID
- API v3 密钥
- 商户证书（apiclient_cert.pem）
- 商户私钥（apiclient_key.pem）
配置步骤
- 进入「系统设置」→「支付管理」→「微信支付」
- 填写基本配置：
- 支付模式：选择直连模式或服务商模式
- 商户号：填写微信支付商户号
- AppID：填写小程序或公众号 AppID
- API v3 密钥：填写32位API密钥
- 上传证书文件：
- 上传商户证书（apiclient_cert.pem）
- 上传商户私钥（apiclient_key.pem）
- 配置回调地址：
- 支付回调：
https://your-domain.com/api/callback/pay/wechat - 退款回调：
https://your-domain.com/api/callback/refund/wechat
- 支付回调：
- 点击「保存配置」
- 点击「测试支付」验证配置是否正确
直连模式 vs 服务商模式
| 对比项 | 直连模式 | 服务商模式 |
|---|---|---|
| 适用对象 | 自有商户号 | 子商户通过服务商接入 |
| 费率 | 标准费率 | 服务商可设置费率 |
| 配置复杂度 | 简单 | 较复杂 |
| 资金结算 | 直接到商户账户 | 通过服务商结算 |
支付宝配置
配置前准备
- 支付宝开放平台 AppID
- 应用私钥
- 支付宝公钥
- 应用网关
配置步骤
- 进入「系统设置」→「支付管理」→「支付宝」
- 填写基本配置：
- AppID：支付宝应用ID
- 应用私钥：RSA2私钥
- 支付宝公钥：支付宝公钥
- 是否沙箱：测试环境选择"是"
- 配置回调地址：
- 异步通知地址
- 同步跳转地址
- 点击「保存配置」
- 点击「测试支付」验证
支付设置
支付开关
- 进入「系统设置」→「支付管理」→「支付设置」
- 配置各支付方式的启用状态：
- 微信支付：开启/关闭
- 支付宝：开启/关闭
- 余额支付：开启/关闭
- 模拟支付：开启/关闭（仅测试环境）
支付参数
| 参数 | 说明 | 默认值 |
|---|---|---|
| 订单超时时间 | 订单支付有效期 | 30分钟 |
| 自动关闭时间 | 超时后自动关闭订单 | 30分钟 |
| 退款有效期 | 支持退款的时间范围 | 7天 |
支付记录
查看支付记录
- 进入「系统设置」→「支付管理」→「支付记录」
- 查看所有支付流水
记录字段
| 字段 | 说明 |
|---|---|
| 支付单号 | 系统生成的支付单号 |
| 订单编号 | 关联的业务订单号 |
| 支付方式 | 微信/支付宝/余额 |
| 支付金额 | 实际支付金额 |
| 支付状态 | 成功/失败/处理中 |
| 支付时间 | 支付完成时间 |
| 交易单号 | 第三方支付平台的交易号 |
筛选查询
- 按支付方式筛选
- 按支付状态筛选
- 按时间范围筛选
- 按订单号搜索
退款管理
退款申请来源
- 用户主动申请退款
- 管理员发起退款
- 系统自动退款（超时等）
退款处理
- 进入「系统设置」→「支付管理」→「退款管理」
- 查看退款申请列表
- 点击「处理」查看详情
- 审核退款申请
- 选择「同意退款」或「拒绝退款」
退款规则
| 退款场景 | 退款金额 | 说明 |
|---|---|---|
| 未服务 | 全额退款 | 退还全部实付金额 |
| 服务中 | 部分退款 | 按已服务时长比例计算 |
| 服务完成 | 协商退款 | 根据具体情况协商 |
退款到账时间
| 支付方式 | 到账时间 |
|---|---|
| 微信支付 | 1-3个工作日 |
| 支付宝 | 1-3个工作日 |
| 余额支付 | 即时到账 |
支付统计
支付概览
- 进入「系统设置」→「支付管理」→「支付统计」
- 查看支付数据统计
统计维度
| 维度 | 说明 |
|---|---|
| 支付方式占比 | 各支付方式的金额/笔数占比 |
| 支付成功/失败率 | 支付成功比例 |
| 日/周/月趋势 | 支付金额/笔数趋势 |
| 退款率 | 退款订单占比 |
常见问题
Q: 支付配置后测试失败？
A: 请检查：
- 商户号、AppID是否正确
- API密钥是否正确
- 证书文件是否正确上传
- 回调地址是否可访问
- 服务器IP是否在支付白名单中
Q: 支付回调收不到？
A:
- 检查回调地址是否正确配置
- 检查服务器是否允许外网访问
- 检查防火墙设置
- 查看支付平台回调日志
Q: 退款失败怎么办？
A:
- 检查原订单支付状态
- 检查退款金额是否超过原订单金额
- 检查商户余额是否充足
- 查看退款失败原因
Q: 如何开启模拟支付？
A:
- 进入「支付设置」
- 开启「模拟支付」开关
- 在测试环境下单时选择模拟支付
- 输入模拟支付密码（默认123456）
Q: 支付手续费怎么算？
A:
- 微信支付：按微信官方费率（通常为0.6%）
- 支付宝：按支付宝官方费率（通常为0.6%）
- 余额支付：无手续费
安全建议
- 保护密钥：不要将API密钥泄露给他人
- 定期检查：定期查看支付记录，发现异常及时处理
- 证书安全：妥善保管支付证书，定期更换
- 回调验签：确保回调接口有签名验证
- 日志记录：保留支付日志，便于问题排查