zhjwxt/niucloud/databasedoc/school_pay_refund.md

school_pay_refund 表文档

表概述

表名: school_pay_refund
功能: 支付退款管理表，用于处理和管理各种业务场景下的退款申请和处理流程，包括课程退费、订单取消、服务纠纷等退款场景，支持多渠道退款、状态跟踪、失败处理和凭证管理，为学校提供完整的退款业务管理和财务对账功能

字段说明

Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int unsigned	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	主键
refund_no	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	退款单号
out_trade_no	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	支付流水号
type	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	支付方式
channel	varchar(50)	utf8mb4_general_ci	NO				select,insert,update,references	支付渠道
money	decimal(10,2)	NULL	NO		0.00		select,insert,update,references	支付金额
reason	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	退款原因
status	varchar(255)	utf8mb4_general_ci	NO		0		select,insert,update,references	支付状态（0.待退款 1. 退款中 2. 已退款 -1已关闭）
create_time	int	NULL	NO		0		select,insert,update,references	创建时间
refund_time	int	NULL	NO		0		select,insert,update,references	支付时间
close_time	int	NULL	NO		0		select,insert,update,references	关闭时间
fail_reason	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	失败原因
voucher	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	支付凭证
trade_type	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	业务类型
trade_id	varchar(50)	utf8mb4_general_ci	NO				select,insert,update,references	业务关联id
refund_type	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	退款方式
main_type	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	操作人类型
main_id	int	NULL	NO		0		select,insert,update,references	操作人
pay_refund_no	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	外部支付方式的退款单号

功能用途

主要功能

• 退款申请管理: 处理各种业务场景下的退款申请和审批流程
• 退款流程控制: 管理退款的完整流程（申请→审核→退款→完成）
• 退款状态跟踪: 实时跟踪退款状态变化和处理进度
• 多渠道退款: 支持多种支付渠道的退款处理（微信、支付宝、银行卡等）
• 退款金额管理: 精确计算和管理退款金额，支持部分退款
• 退款凭证管理: 管理退款凭证和相关票据信息
• 失败处理机制: 记录退款失败原因，支持重新处理
• 业务关联: 与原始支付记录和相关业务进行关联
• 操作人员管理: 记录退款操作的具体执行人员

业务场景

• 课程退费: 学员申请课程退费的退款处理
• 订单取消退款: 订单取消后的自动退款
• 服务纠纷退款: 因服务质量问题产生的退款
• 系统错误退款: 因系统错误导致的多收费用退款
• 部分退款: 课程部分完成后的按比例退款
• 批量退款: 因活动取消等原因的批量退款处理
• 退款审核: 财务人员审核退款申请的合理性
• 退款对账: 与第三方支付平台进行退款对账

关联关系

主要关联表

• school_pay: 支付记录表 (out_trade_no)
• school_member: 会员信息表 (main_id)
• school_order: 订单信息表 (通过trade_id关联)
• school_contract: 合同信息表 (通过trade_id关联)
• school_course: 课程信息表 (通过业务关联)
• school_sys_user: 系统用户表 (操作人员信息)
• school_member_account: 会员账户表 (退款到余额)
• school_member_account_log: 账户流水表 (资金变动记录)

关联说明

• 支付关联: out_trade_no关联原始支付记录，确保退款与支付匹配
• 会员关联: main_id关联退款接收方的会员信息
• 业务关联: 通过trade_type和trade_id关联具体的业务记录
• 操作人关联: main_id在不同main_type下关联不同类型的操作人员
• 账户关联: 退款到余额时需要关联会员账户信息
• 流水关联: 退款完成后在账户流水表中记录资金变动
• 渠道关联: channel和type字段关联支付渠道配置

索引建议

• 主键索引: id (已存在)
• 唯一索引: refund_no (退款单号唯一性)
• 外键索引:
  • out_trade_no (支付流水号查询)
  • main_id (操作人查询)
• 业务索引:
  • trade_type (业务类型查询)
  • trade_id (业务ID查询)
• 状态索引: status (退款状态查询)
• 时间索引:
  • create_time (创建时间查询)
  • refund_time (退款时间查询)
  • close_time (关闭时间查询)
• 复合索引:
  • (out_trade_no, status) (支付退款状态查询)
  • (main_id, status) (操作人退款状态查询)
  • (trade_type, trade_id) (业务关联查询)
  • (type, status) (退款方式状态查询)
  • (create_time, status) (时间状态查询)

注意事项

• 金额精度: money字段使用decimal(10,2)，确保财务计算精度
• 退款限制: 退款金额不能超过原支付金额
• 状态流转: 退款状态有严格的流转规则（0→1→2或0→-1）
• 时间逻辑: refund_time不能早于create_time，close_time只在关闭时设置
• 支付关联: 必须基于有效的支付记录才能发起退款
• 渠道一致性: 退款渠道应与原支付渠道保持一致
• 重复退款: 防止同一笔支付重复退款或超额退款
• 失败处理: 退款失败时必须记录详细的fail_reason
• 凭证管理: voucher字段用于存储退款凭证，确保可追溯
• 业务完整性: trade_type和trade_id必须与原支付记录保持一致
• 操作权限: 不同类型的操作人员有不同的退款权限
• 数据一致性: 退款成功后必须同步更新相关业务状态
• 审核机制: 大额退款需要多级审核确认
• 对账要求: 定期与第三方支付平台进行退款对账
• 法律合规: 退款操作需要符合相关法律法规要求