完善C端功能、通知明细及接口文档

internal/httpapi/finance.go

@@ -41,6 +41,34 @@ func (a *API) paymentAccounts(w http.ResponseWriter, r *http.Request) {
 	writeSuccess(w, r, result)
 }
 
+func (a *API) walletLedgers(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodGet {
+		methodNotAllowed(w, r, http.MethodGet)
+		return
+	}
+	principal, ok := a.authenticateFinanceMember(w, r)
+	if !ok {
+		return
+	}
+	page, ok := optionalPositiveInt(w, r, "page")
+	if !ok {
+		writeFinanceError(w, r, finance.ErrPageInvalid)
+		return
+	}
+	pageSize, ok := optionalPositiveInt(w, r, "page_size")
+	if !ok {
+		writeFinanceError(w, r, finance.ErrPageSizeInvalid)
+		return
+	}
+	result, err := a.finance.WalletLedgers(r.Context(), principal.TenantID, principal.MemberID,
+		page, pageSize, r.URL.Query().Get("biz_type"), r.URL.Query().Get("direction"))
+	if err != nil {
+		writeFinanceError(w, r, err)
+		return
+	}
+	writeSuccess(w, r, result)
+}
+
 func (a *API) withdrawalQuote(w http.ResponseWriter, r *http.Request) {
 	if r.Method != http.MethodPost {
 		methodNotAllowed(w, r, http.MethodPost)
@@ -256,6 +284,8 @@ func writeFinanceError(w http.ResponseWriter, r *http.Request, err error) {
 		writeError(w, r, http.StatusBadRequest, 30000, "PAGE_INVALID", "validation failed", map[string]any{"field": "page"})
 	case errors.Is(err, finance.ErrPageSizeInvalid):
 		writeError(w, r, http.StatusBadRequest, 30000, "PAGE_SIZE_INVALID", "validation failed", map[string]any{"field": "page_size"})
+	case errors.Is(err, finance.ErrLedgerFilterInvalid):
+		writeError(w, r, http.StatusBadRequest, 30000, "LEDGER_FILTER_INVALID", "validation failed", nil)
 	case errors.Is(err, finance.ErrStatusInvalid):
 		writeError(w, r, http.StatusBadRequest, 30000, "WITHDRAWAL_STATUS_INVALID", "validation failed", map[string]any{"field": "status"})
 	case errors.Is(err, finance.ErrRechargeStatusInvalid):