PrimerError

public enum PrimerError: PrimerErrorProtocol {
    public var errorId: String { get }
    public var diagnosticsId: String { get }
    public var recoverySuggestion: String? { get }
    public var errorDescription: String? { get }
    public var errorUserInfo: [String: Any] { get }
    public var underlyingErrorCode: String? { get }
}

import SwiftUI
import PrimerSDK

struct CheckoutScreen: View {
    @StateObject private var session = PrimerCheckoutSession(clientToken: clientToken)

    var body: some View {
        ScrollView {
            PrimerCardForm()
        }
        .primerCheckoutSession(session) { state in
            handle(state)
        }
    }

    private func handle(_ state: PrimerCheckoutState) {
        switch state {
        case let .failure(error):
            handle(error)
        case let .success(result):
            print("Payment completed: \(result.paymentId)")
        case .dismissed, .initializing, .ready:
            break
        @unknown default:
            break
        }
    }

    private func handle(_ error: PrimerError) {
        // Always log the diagnostics ID — share it with Primer support.
        print("Checkout failed [\(error.errorId)]: \(error.localizedDescription)")
        print("Diagnostics ID: \(error.diagnosticsId)")

        switch error.errorId {
        case "payment-cancelled":
            // Shopper backed out — usually no message needed.
            break
        default:
            // Show your own branded, localized error message here.
            showRetryAlert(suggestion: error.recoverySuggestion)
        }
    }
}

extension CheckoutCoordinator: PrimerCheckoutPresenterDelegate {
    func primerCheckoutPresenterDidFailWithError(_ error: PrimerError) {
        print("Checkout failed [\(error.errorId)] — diagnosticsId: \(error.diagnosticsId)")
        // Present your own error UI; use error.recoverySuggestion to decide whether to offer a retry.
    }
}