支付订单管理
系统的支付体系分为两层:业务订单承载商户发起的支付请求(普通订单与网关订单两种形态),支付交易承载实际资金流转(退款、分账等资金操作都在这一层发起)。理解这个分层是查询和处理订单的基础。
三层订单模型
| 层 | 页面 | 承载内容 | 典型操作 |
|---|---|---|---|
| 业务订单 | 普通订单 | 商户通过 /unipay/pay 发起的支付单(扫码、JSAPI、H5 等) | 查看、关闭、导出 |
| 业务订单 | 网关订单 | 通过统一收银台 / 聚合扫码(/unipay/gateway/pre-pay)生成的支付单 | 查看、关闭、导出 |
| 资金交易 | 支付交易 | 与通道实际发生资金往来的交易记录,一个业务订单可能对应多笔 | 查看、退款、发起分账、同步、关闭 |
为什么在这里退款
「普通订单」「网关订单」页面只有查看与关闭;退款、发起分账在「支付交易」页的操作列「更多」菜单中——因为退款分账针对的是资金,而不是业务单。
页面入口
| 端 | 菜单路径 |
|---|---|
| 运营端 | 交易订单 → 支付订单 → 普通订单 / 网关订单;交易订单 → 支付交易 |
| 商户端 | 交易订单 → 支付订单 → 普通订单 / 网关订单;交易订单 → 支付交易 |
运营端的查询条件比商户端多出「商户」「应用」筛选(跨商户视角),其余功能一致。
普通订单
查询条件:商户订单号、标题、商户(运营端)、应用、业务状态、支付产品、支付能力、创建时间、金额区间。
列表列:平台订单号、商户订单号、标题、金额、业务状态、支付产品、支付能力、商户、创建时间。
操作:
| 操作 | 条件 | 说明 |
|---|---|---|
| 查看 | — | 打开详情抽屉 |
| 关闭 | 待支付 | 手动关闭未支付订单(需订单管理权限) |
| 导出 | — | 右上角导出列表数据 |
详情抽屉包含:商户与订单标识(平台订单号 / 商户订单号 / 资金交易号)、业务状态与金额、支付产品 / 能力 / 通道 / 方式 / 通道商户号 / 通道订单号、资金状态、门店号、支付时间组、买家信息、退款可退余额、通知与回跳地址、错误信息。
网关订单
网关订单是经统一收银台或聚合扫码产生的业务订单,除了普通订单的查询维度外,还可以按网关类型(统一收银台 / 聚合扫码)筛选,业务状态包含「支付中」。
操作与普通订单一致(查看、关闭、导出),其中关闭条件为「待支付 / 支付中」(网关订单支付中也可关闭);详情抽屉额外包含资金状态、可退余额、客户端 IP 等信息。
网关订单的产生与配置见网关支付。
支付交易
支付交易是资金层的记录:每笔成功支付对应一笔交易,记录通道、通道商户号、入账金额、可退余额与分账状态。
查询条件:资金交易号、通道订单号、商户、应用、资金状态(初始化 / 处理中 / 成功 / 失败 / 关闭 / 撤销)、交易形态(普通 / 网关)、分账状态(无 / 处理中 / 完成 / 不支持)、通道商户号、创建时间、金额区间。
列表列:交易号、交易形态、通道订单号、金额、入账金额、可退余额、资金状态、分账状态、支付通道、支付渠道、通道商户号、支付时间、商户、创建时间。
操作(操作列「更多」下拉,按状态动态显示):
| 操作 | 显示条件 | 说明 |
|---|---|---|
| 订单明细 | — | 按业务订单号跳转到对应的普通订单 / 网关订单页 |
| 查看 | — | 详情抽屉 |
| 退款 | 资金状态=成功且有可退余额 | 发起退款,见退款管理 |
| 发起分账 | 资金状态=成功且分账状态=无 | 发起分账,见支付分账 |
| 关闭 | 初始化 / 处理中 | 关闭未完成的交易 |
| 同步 | 非终态 | 向通道主动拉取最新状态 |
什么时候用「同步」
支付依赖通道回调推进状态。如果回调丢失(网络原因、地址不可达),订单会停留在中间态——对这笔交易执行「同步」,系统会主动查询通道并回填状态。