Эх сурвалжийг харах

docs(汇安融): 退款 10.4 补 reason 一行的说明

`reason` 是上游必填而规范漏写的格子(联调实测),但站在调用方角度它是
**选填** —— 留空平台补默认值,不会因此失败。所以表里标「否」,另加一句
说清为什么选填:上游没公布长度上限,平台就不强制调用方猜一个。

不提「上游」是哪家,也不写长度建议 —— 上限没人公布过,写一个数出来就是
编契约。
alphaH 2 долоо хоног өмнө
parent
commit
9796876cd7

+ 3 - 0
frontend/src/views/module_payment/apikey/docs/har-openapi.md

@@ -178,9 +178,12 @@ POST /payment/openapi/har/refund
 | `merchant_code` | string | 否 | **你租户下配了多个商户号时必填**,与其它三个接口同一个值 |
 | `order_no` | string | 二选一 | 平台订单号(10.2 响应里的 `order_no`) |
 | `out_biz_no` | string | 二选一 | 你自己的订单号 |
+| `reason` | string | 否 | 退款原因。**留空时平台补一个默认值**(`商户申请退款`);填了就以你填的为准 |
 
 > ⚠️ **本接口只有全额退款,请求里没有金额字段。** 这条通道的上游不支持部分退款 —— 发起即退整笔。需要退一部分的场景请先联系平台。
 
+> ℹ️ **`reason` 为什么是选填**:通道上游把它列为必填,但没公布长度上限,所以平台不强制你填 —— 留空就替你补一个默认值,不会因此失败。想在自己的账上区分退款来源就填上。
+
 **响应**(B 型,`data` 内):结构与 10.3 完全相同(同一份订单)。
 
 > ⚠️ **返回时 `trade_status` 是 `"4"`(退款中),不是 `"2"`。** 同步返回只代表平台已把退款指令发给上游,**不代表钱已经退回用户账上**。