|
|
@@ -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"`。** 同步返回只代表平台已把退款指令发给上游,**不代表钱已经退回用户账上**。
|