hl-api-changelog/changelogs/2026-03/2026-03-23_balance_proof_display.md
API Changelog Bot a7605f7414 docs: 订单详情需展示尾款凭证图片
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 10:46:32 +08:00

29 行
904 B
Markdown

此文件含有模棱两可的 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` 有值):尾款金额旁显示"凭证"链接或缩略图,点击可放大查看图片