Add currency mismatch warning banner to dashboard

- Created CurrencyMismatchBanner SwiftUI view component
- Added currency mismatch detection in DashboardViewModel
- Display banner when site and payment gateway currencies differ
- Banner is dismissible and tracks dismissal in UserDefaults
- Added analytics event for banner dismissal

Co-authored-by: staskus <[email protected]>

Author: Copilot

Modules/Sources/WooFoundationCore/Analytics/WooAnalyticsStat.swift

@@ -138,6 +138,7 @@ public enum WooAnalyticsStat: String {
     case dashboardMainStatsWaitingTimeLoaded = "dashboard_main_stats_waiting_time_loaded"
     case dashboardTopPerformersWaitingTimeLoaded = "dashboard_top_performers_waiting_time_loaded"
     case dashboardStoreTimezoneDifferFromDevice = "dashboard_store_timezone_differ_from_device"
+    case dashboardCurrencyMismatchBannerDismissed = "dashboard_currency_mismatch_banner_dismissed"
 
     // MARK: Dashboard stats custom range
     case dashboardStatsCustomRangeAddButtonTapped = "dashboard_stats_custom_range_add_button_tapped"

WooCommerce/Classes/Analytics/WooAnalyticsEvent+Dashboard.swift

@@ -44,6 +44,9 @@ extension WooAnalyticsEvent {
                                      properties: [Keys.storeTimezone: storeTimezoneText,
                                                   Keys.localTimezone: localTimezoneText])
         }
+
+        /// Tracked when the currency mismatch banner is dismissed.
+        static let currencyMismatchBannerDismissed = WooAnalyticsEvent(statName: .dashboardCurrencyMismatchBannerDismissed, properties: [:])
     }
 }
 

WooCommerce/Classes/Extensions/UserDefaults+Woo.swift

@@ -76,6 +76,9 @@ extension UserDefaults {
 
         // CIAB Bookings tab availability
         case ciabBookingsTabAvailable
+
+        // Currency mismatch banner dismissal
+        case currencyMismatchBannerDismissed
     }
 }
 

WooCommerce/Classes/ViewRelated/Dashboard/CurrencyMismatchBanner.swift

@@ -0,0 +1,78 @@
+import SwiftUI
+
+/// A banner warning about currency mismatch between site and user account
+struct CurrencyMismatchBanner: View {
+    let siteCurrency: String
+    let accountCurrency: String
+    
+    /// Closure invoked when the dismiss button is tapped
+    var dismissAction: () -> Void = {}
+    
+    // Tracks the scale of the view due to accessibility changes
+    @ScaledMetric private var scale: CGFloat = 1.0
+    
+    var body: some View {
+        Group {
+            HStack(alignment: .top, spacing: Layout.horizontalSpacing) {
+                Image(systemName: "exclamationmark.triangle.fill")
+                    .resizable()
+                    .frame(width: Layout.iconDimension * scale, height: Layout.iconDimension * scale)
+                    .foregroundColor(Color(.wooOrange))
+                VStack(alignment: .leading, spacing: Layout.verticalTextSpacing) {
+                    Text(Localization.title)
+                        .fontWeight(.semibold)
+                        .bodyStyle()
+                    Text(String(format: Localization.message, siteCurrency, accountCurrency))
+                        .bodyStyle()
+                        .foregroundColor(Color(.text.secondary))
+                }
+                Spacer()
+                Button(action: dismissAction) {
+                    Image(systemName: "xmark")
+                        .foregroundColor(Color(.text.secondary))
+                }
+            }
+            .padding(insets: Layout.padding)
+        }
+        .background(Color(.bannerBackground))
+        .fixedSize(horizontal: false, vertical: true)
+        .contentShape(Rectangle())
+    }
+}
+
+private extension CurrencyMismatchBanner {
+    enum Localization {
+        static let title = NSLocalizedString(
+            "currencyMismatchBanner.title",
+            value: "Currency mismatch detected",
+            comment: "Title of the currency mismatch warning banner on the dashboard."
+        )
+        static let message = NSLocalizedString(
+            "currencyMismatchBanner.message",
+            value: "Your site uses %1$@ but your payment account uses %2$@. This may cause issues with payments. Please update your account currency to match your site's currency in your payment gateway settings.",
+            comment: "Message of the currency mismatch warning banner. %1$@ is the site currency code (e.g. USD), %2$@ is the account currency code (e.g. GBP)."
+        )
+    }
+    
+    enum Layout {
+        static let padding = EdgeInsets(top: 16, leading: 16, bottom: 16, trailing: 16)
+        static let iconDimension = CGFloat(20)
+        static let horizontalSpacing = CGFloat(12)
+        static let verticalTextSpacing = CGFloat(8)
+    }
+}
+
+struct CurrencyMismatchBanner_Previews: PreviewProvider {
+    static var previews: some View {
+        CurrencyMismatchBanner(siteCurrency: "USD", accountCurrency: "GBP")
+            .preferredColorScheme(.light)
+            .previewLayout(.sizeThatFits)
+        CurrencyMismatchBanner(siteCurrency: "USD", accountCurrency: "GBP")
+            .preferredColorScheme(.dark)
+            .previewLayout(.sizeThatFits)
+        CurrencyMismatchBanner(siteCurrency: "EUR", accountCurrency: "CAD")
+            .preferredColorScheme(.light)
+            .environment(\.sizeCategory, .extraExtraExtraLarge)
+            .previewLayout(.sizeThatFits)
+    }
+}

WooCommerce/Classes/ViewRelated/Dashboard/DashboardView.swift

@@ -157,6 +157,9 @@ struct DashboardView: View {
             viewModel.onPullToRefresh()
         }
         .safeAreaInset(edge: .bottom) {
+            currencyMismatchBanner
+                .renderedIf(viewModel.showCurrencyMismatchBanner)
+
             jetpackBenefitBanner
                 .renderedIf(shouldShowJetpackBenefitsBanner)
 
@@ -340,6 +343,16 @@ private extension DashboardView {
         .padding(.horizontal, Layout.padding)
     }
 
+    var currencyMismatchBanner: some View {
+        CurrencyMismatchBanner(
+            siteCurrency: viewModel.siteCurrency,
+            accountCurrency: viewModel.accountCurrency,
+            dismissAction: {
+                viewModel.dismissCurrencyMismatchBanner()
+            }
+        )
+    }
+
     var jetpackBenefitBanner: some View {
         JetpackBenefitsBanner(tapAction: {
             ServiceLocator.analytics.track(event: .jetpackBenefitsBanner(action: .tapped))

WooCommerce/Classes/ViewRelated/Dashboard/DashboardViewModel.swift

@@ -1,6 +1,7 @@
 import Foundation
 import Yosemite
 import Combine
+import CocoaLumberjack
 import enum Networking.DotcomError
 import enum Storage.StatsVersion
 import protocol Storage.StorageManagerType
@@ -65,6 +66,12 @@ final class DashboardViewModel: ObservableObject {
 
     @Published private(set) var isSiteEligibleToInstallJetpack = true
 
+    @Published private(set) var showCurrencyMismatchBanner = false
+
+    @Published private(set) var siteCurrency: String = ""
+
+    @Published private(set) var accountCurrency: String = ""
+
     @Published private var hasOrders = false
 
     @Published private(set) var isEligibleForInbox = false
@@ -199,6 +206,8 @@ final class DashboardViewModel: ObservableObject {
         await reloadCardsWithBackgroundUpdateSupportIfNeeded()
 
         await blazeLocalNotificationScheduler.scheduleNoCampaignReminder()
+        
+        await checkCurrencyMismatch()
     }
 
     func handleCustomizationDismissal() {
@@ -778,6 +787,68 @@ private extension DashboardViewModel {
     func updateJetpackBannerVisibilityFromAppSettings() async {
         jetpackBannerVisibleFromAppSettings = await loadJetpackBannerVisibilityFromAppSettings()
     }
+
+    @MainActor
+    func checkCurrencyMismatch() async {
+        // Check if banner was previously dismissed
+        let isDismissed = userDefaults.bool(forKey: UserDefaults.Key.currencyMismatchBannerDismissed.rawValue)
+        guard !isDismissed else {
+            showCurrencyMismatchBanner = false
+            return
+        }
+
+        let siteCurrencyCode = ServiceLocator.currencySettings.currencyCode.rawValue
+        
+        // Try to get payment gateway account currency
+        guard let accountCurrencyCode = await loadPaymentGatewayAccountCurrency() else {
+            showCurrencyMismatchBanner = false
+            return
+        }
+
+        // Check if currencies mismatch
+        if siteCurrencyCode != accountCurrencyCode {
+            siteCurrency = siteCurrencyCode
+            accountCurrency = accountCurrencyCode
+            showCurrencyMismatchBanner = true
+            
+            // Log the mismatch for analytics/debugging
+            DDLogWarn("⚠️ Currency mismatch detected: Site currency \(siteCurrencyCode) differs from payment account currency \(accountCurrencyCode)")
+        } else {
+            showCurrencyMismatchBanner = false
+        }
+    }
+
+    func dismissCurrencyMismatchBanner() {
+        showCurrencyMismatchBanner = false
+        userDefaults.set(true, forKey: UserDefaults.Key.currencyMismatchBannerDismissed.rawValue)
+        ServiceLocator.analytics.track(event: .Dashboard.currencyMismatchBannerDismissed)
+    }
+
+    @MainActor
+    private func loadPaymentGatewayAccountCurrency() async -> String? {
+        await withCheckedContinuation { continuation in
+            // Load payment gateway accounts
+            let action = CardPresentPaymentAction.loadAccounts(siteID: siteID) { [weak self] result in
+                guard let self = self else {
+                    continuation.resume(returning: nil)
+                    return
+                }
+                
+                // Try to get the selected payment gateway account
+                let selectedAccountAction = CardPresentPaymentAction.selectedPaymentGatewayAccount { account in
+                    if let account = account {
+                        continuation.resume(returning: account.defaultCurrency)
+                    } else {
+                        // If no account is selected, try to load from storage
+                        let accounts = self.storageManager.viewStorage.loadPaymentGatewayAccounts(siteID: self.siteID)
+                        continuation.resume(returning: accounts.first?.defaultCurrency)
+                    }
+                }
+                self.stores.dispatch(selectedAccountAction)
+            }
+            stores.dispatch(action)
+        }
+    }
 }
 
 // MARK: InAppFeedback card