feat(v2): outbox 退款感知(refund_id 进唯一键)+ 投递门禁放行退款态 + Enqueue 贯通 refundID

internal/model/v2.go

@@ -32,12 +32,24 @@ const (
 type RefundStatus string
 
 const (
-	RefundRequested  RefundStatus = "requested"
-	RefundProcessing RefundStatus = "processing"
-	RefundSucceeded  RefundStatus = "succeeded"
-	RefundFailed     RefundStatus = "failed"
+	RefundRequested     RefundStatus = "requested"
+	RefundProcessing    RefundStatus = "processing"
+	RefundSucceeded     RefundStatus = "succeeded"
+	RefundFailed        RefundStatus = "failed"
+	RefundManualPending RefundStatus = "manual_pending" // crypto 自托管:待运营人工 sweep 退款
 )
 
+// Settled 报告订单是否「已真正收到过钱」(paid 及其后的退款态)。webhook 投递门禁用:
+// 只有已结算订单的 outbox 才放行——payment 事件挡住崩溃窗口里的未付单,refund 事件
+// 则因订单已 paid 过而正常放行(不会因订单转入退款态被卡)。
+func (s OrderStatusV2) Settled() bool {
+	switch s {
+	case OrderPaidV2, OrderRefundingV2, OrderPartRefundedV2, OrderRefundedV2:
+		return true
+	}
+	return false
+}
+
 // ---- 业务订单(购买账本)----
 
 type OrderV2 struct {