数据表目录
这份目录页只负责“表去哪看、表大概干什么”，详细结构仍以 payment-middle-ddl.sql 为准。
基础字典
| 表名 |
用途 |
说明 |
ma_payment_type |
支付方式字典 |
维护支付方式编码、名称、图标和启用状态 |
ma_system_config |
系统配置表 |
维护全局配置键值 |
商户主体
| 表名 |
用途 |
说明 |
ma_merchant_group |
商户分组表 |
作为路由绑定和商户归类的输入条件 |
ma_merchant |
商户表 |
商户主体资料，也是后台登录主体 |
ma_merchant_api_credential |
商户 API 凭证表 |
开放接口签名凭证，V1 使用 MD5 key，V2 保存 RSA 公钥，与后台登录分离 |
ma_merchant_policy |
商户策略预留表 |
预留的商户策略结构 |
支付编排
| 表名 |
用途 |
说明 |
ma_payment_plugin |
支付插件注册表 |
扫描和注册支付插件定义 |
ma_payment_plugin_conf |
支付插件 API 配置表 |
插件初始化配置和结算周期配置 |
ma_payment_channel |
支付通道表 |
维护平台通道和商户自有通道 |
ma_payment_poll_group |
支付轮询组表 |
承载轮询策略和候选通道编排 |
ma_payment_poll_group_channel |
支付轮询组-通道编排表 |
轮询组内的通道顺序和权重配置 |
ma_payment_poll_group_bind |
商户分组-轮询组绑定表 |
商户分组与轮询组的映射关系 |
交易订单
| 表名 |
用途 |
说明 |
ma_biz_order |
业务订单表 |
统一业务订单入口，只承载业务事实、收银台恢复所需信息（subject/body/notify_url/return_url/client_ip/device）和业务扩展参数 |
ma_pay_order |
支付单表 |
记录支付发起、状态推进和回调信息，扩展字段只留商户附加参数 |
ma_refund_order |
退款单表 |
记录退款发起、状态推进和结果，扩展字段只留商户附加参数 |
ma_transfer_order |
转账单表 |
记录转账发起、状态推进和渠道结果，扩展字段只留商户附加参数 |
ma_settlement_order |
清算单表 |
记录清算批次和清算状态，扩展字段只留清算附加信息 |
ma_settlement_item |
清算明细表 |
记录清算单内的明细拆分 |
资金账户
| 表名 |
用途 |
说明 |
ma_merchant_account |
商户余额账户表 |
记录商户余额、冻结、可用等账户信息 |
ma_merchant_account_ledger |
商户余额流水表 |
记录账户变更流水和账务明细 |
运维日志
| 表名 |
用途 |
说明 |
ma_channel_notify_log |
通道通知日志表 |
记录通道侧通知、重试和失败原因 |
ma_pay_callback_log |
支付回调日志表 |
记录支付回调处理和幂等结果 |
ma_channel_daily_stat |
通道日统计表 |
记录通道成功率、耗时和健康度数据 |
ma_notify_task |
商户通知任务表 |
记录商户异步通知任务和重试情况 |
文件与后台
| 表名 |
用途 |
说明 |
ma_file_asset |
文件表 |
记录上传文件、预览、下载和存储位置 |
ma_admin_user |
管理员用户表 |
记录后台管理员账号信息 |
使用建议
- 先看
tables.md，再看 DDL
- 如果字段定义变了，以 DDL 为准
- 如果表用途变了，先补 DDL 注释，再补这里的目录说明
ext_json 使用分区结构保存轻量运行上下文：顶层可放 _protocol_version，商户透传放 merchant，支付载体放 payment，收银台承接放 presentation- 回调、通知、重试和原始报文使用专门日志/任务表，不进入订单扩展字段
- 表级说明后面可以按业务域继续拆成独立文档
