文件
hl-api-changelog/changelogs/2026-03/2026-03-23_balance_proof_display.md
T
2026-03-23 10:46:32 +08:00

29 行
904 B
Markdown
原始文件 Blame 文件历史

此文件含有模棱两可的 Unicode 字符
此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。
# 订单详情展示尾款凭证
**日期**: 2026-03-23
**页面**: 订单详情页 → 金额明细区域
**类型**: 前端新增
---
## 说明
上传尾款凭证后,订单详情接口已返回 `balanceProofUrl` 字段,但前端没有展示。
## 后端已返回的字段
订单详情接口 `GET /admin/order/{orderId}` 响应中:
| 字段 | 类型 | 说明 |
|------|------|------|
| balanceProofUrl | String | 尾款凭证图片URL,null=未上传 |
| balanceAmount | BigDecimal | 尾款金额 |
| balancePayMethod | String | 尾款支付方式:ONLINE / OFFLINE |
## 前端展示建议
在金额明细区域的"尾款"行:
- **凭证未上传**(`balanceProofUrl` 为 null):显示尾款金额 + 上传按钮(条件见之前的 changelog)
- **凭证已上传**(`balanceProofUrl` 有值):尾款金额旁显示"凭证"链接或缩略图,点击可放大查看图片