退款管理
退款针对支付交易发起（不是业务订单），支持界面操作与 API 两种方式。退款金额受原交易的「可退余额」约束，支持多次部分退款。
入口
| 方式 | 入口 | 说明 |
|---|---|---|
| 界面发起 | 交易订单 → 支付交易 → 操作列「更多 → 退款」 | 运营端与商户端均可，运营端代发会携带商户号 |
| API 发起 | POST /unipay/refund | 业务系统调用，见申请退款 |
| 退款单查询 | 交易订单 → 退款订单 | 两端均可查看退款单状态与明细 |
界面发起退款
在「支付交易」列表找到目标交易（资金状态为「成功」且可退余额大于 0），点击操作列「更多 → 退款」：
- 系统先查询交易详情，回填资金交易号与当前可退余额；
- 填写退款金额（弹窗已默认预填全部可退余额，改小即为部分退款；点「一键全额退款」可重新填满）与退款原因；
- 二次确认后提交，生成退款单。
部分退款
一笔支付交易可以多次部分退款，累计退款金额不能超过原交易金额；「可退余额」在每次退款成功后会相应扣减，在支付交易与退款单详情中都可查看。
退款状态流转
| 状态 | 说明 |
|---|---|
| 退款中（progress） | 已提交通道处理，等待结果 |
| 成功（success） | 退款到账 |
| 失败（fail） | 通道拒绝或处理失败（余额不足、超过可退期限等） |
| 已关闭（close） | 退款单被关闭，不再处理 |
退款订单页
查询条件：退款单号、资金交易号、商户、应用、商户订单号、退款状态、交易类型（普通 / 网关）、支付产品、创建时间。
列表列：退款单号、交易号、商户订单号、金额、退款状态、交易类型、产品、商户、创建时间。
操作：
| 操作 | 条件 | 说明 |
|---|---|---|
| 查看 | — | 详情抽屉（身份信息 / 关联资金 / 金额与状态 / 通道快照 / 通知与审计） |
| 同步 | 退款中 | 向通道拉取退款结果，回调丢失时使用 |
| 手动关闭 | 「退款中」且超过 7 天 | 长期无结果的退款单人工关闭归档 |
| 导出 | — | 右上角导出 |
常见问题
| 现象 | 处理 |
|---|---|
| 退款一直「退款中」 | 通道回调未到达，对该退款单执行「同步」；超过 7 天可手动关闭后重新发起 |
| 退款失败提示余额不足 | 原交易可能已被部分退款或通道侧结算变动，核对「可退余额」 |
| 商户订单页找不到退款按钮 | 退款入口在「支付交易」页而非「普通订单 / 网关订单」页 |