訂單退款邏輯總結（含訂單拆分）

1. 退款訂單表結構

從數據庫表 eb_store_order_refund 可以看到退款訂單的核心字段：

- store_order_id : 關聯原訂單ID

- refund_type : 退款類型（0僅退款，1退貨退款）

- refund_num : 退款件數

- refund_price : 申請退款金額

- refunded_price : 已退款金額

- cart_info : 退款商品信息（JSON格式存儲購物車數據）

2. 訂單拆分退款核心流程 2.1 觸發條件

當用戶申請部分商品退款時，系統會觸發訂單拆分邏輯，主要發生在：

- 僅退款部分商品

- 退貨退款部分商品

2.2 拆分處理流程

步驟1：調用訂單拆分服務

// StoreOrderRefundServices.php 中的 agreeRefund 方法

$splitOrder = $this->storeOrderSplitServices->equalSplit($order, $refund);

步驟2：equalSplit方法處理邏輯 （StoreOrderSplitServices.php）

- 購物車數據拆分 ：從原訂單的購物車數據中分離出要退款的商品

- 創建新訂單 ：為剩余商品創建新的子訂單

- 金額重新計算 ：

 - 按比例分攤優惠券金額

 - 按比例分攤積分抵扣

 - 重新計算運費

 - 重新計算傭金

步驟3：退款金額計算

// 計算拆分后的退款金額

$refundPrice = $refund['refund_price']; // 用戶申請的退款金額

$refundedPrice = $refund['refunded_price']; // 已退款金額

$splitPrice = $order['pay_price'] - $refundPrice; // 剩余訂單金額

2.3 數據一致性處理

庫存回退 ：

- 退款商品庫存自動回退

- 新訂單商品庫存保持不變

優惠券處理 ：

- 如果優惠券被部分使用，按比例退回剩余價值

- 新訂單重新計算優惠券抵扣

積分處理 ：

- 退回退款商品對應的積分

- 新訂單積分重新計算

傭金處理 ：

- 取消退款商品的傭金

- 新訂單傭金重新計算

3. 關鍵代碼邏輯

3.1 訂單拆分核心方法

3.2 退款處理完整流程