added ledger as souec of funds for payouts

2026-03-03 21:03:30 +03:00
parent 3f578353da
commit 51c72a87ae
29 changed files with 796 additions and 385 deletions
--- a/frontend/pweb/lib/app/router/payout_shell.dart
+++ b/frontend/pweb/lib/app/router/payout_shell.dart
@@ -5,8 +5,10 @@ import 'package:go_router/go_router.dart';
 import 'package:provider/provider.dart';

 import 'package:pshared/controllers/balance_mask/wallets.dart';
+import 'package:pshared/controllers/payment/source.dart';
 import 'package:pshared/models/payment/type.dart';
 import 'package:pshared/models/recipient/recipient.dart';
+import 'package:pshared/provider/ledger.dart';
 import 'package:pshared/provider/organizations.dart';
 import 'package:pshared/provider/payment/amount.dart';
 import 'package:pshared/provider/payment/flow.dart';
@@ -49,7 +51,6 @@ import 'package:pweb/services/payments/csv_input.dart';

 import 'package:pweb/generated/i18n/app_localizations.dart';

-
 RouteBase payoutShellRoute() => ShellRoute(
  builder: (context, state, child) => MultiProvider(
    providers: [
@@ -82,10 +83,19 @@ RouteBase payoutShellRoute() => ShellRoute(
            provider!..update(recipients, methods),
      ),
      ChangeNotifierProvider(create: (_) => PaymentAmountProvider()),
+      ChangeNotifierProxyProvider2<
+        WalletsController,
+        LedgerAccountsProvider,
+        PaymentSourceController
+      >(
+        create: (_) => PaymentSourceController(),
+        update: (_, wallets, ledger, controller) =>
+            controller!..update(wallets, ledger),
+      ),
      ChangeNotifierProxyProvider6<
        OrganizationsProvider,
        PaymentAmountProvider,
-        WalletsController,
+        PaymentSourceController,
        PaymentFlowProvider,
        RecipientsProvider,
        PaymentMethodsProvider,
@@ -97,7 +107,7 @@ RouteBase payoutShellRoute() => ShellRoute(
              _,
              organization,
              payment,
-              wallet,
+              source,
              flow,
              recipients,
              methods,
@@ -106,7 +116,7 @@ RouteBase payoutShellRoute() => ShellRoute(
              ..update(
                organization,
                payment,
-                wallet,
+                source,
                flow,
                recipients,
                methods,
@@ -212,23 +222,12 @@ RouteBase payoutShellRoute() => ShellRoute(
      path: routerPage(Pages.dashboard),
      pageBuilder: (context, _) => NoTransitionPage(
        child: DashboardPage(
-          onRecipientSelected: (recipient) => _startPayment(
-            context,
-            recipient: recipient,
-          ),
-          onGoToPaymentWithoutRecipient: (type) => _startPayment(
-            context,
-            recipient: null,
-            paymentType: type,
-          ),
-          onTopUp: (wallet) => _openWalletTopUp(
-            context,
-            wallet,
-          ),
-          onWalletTap: (wallet) => _openWalletEdit(
-            context,
-            wallet,
-          ),
+          onRecipientSelected: (recipient) =>
+              _startPayment(context, recipient: recipient),
+          onGoToPaymentWithoutRecipient: (type) =>
+              _startPayment(context, recipient: null, paymentType: type),
+          onTopUp: (wallet) => _openWalletTopUp(context, wallet),
+          onWalletTap: (wallet) => _openWalletEdit(context, wallet),
        ),
      ),
    ),
@@ -239,10 +238,8 @@ RouteBase payoutShellRoute() => ShellRoute(
        final loc = AppLocalizations.of(context)!;
        return NoTransitionPage(
          child: RecipientAddressBookPage(
-            onRecipientSelected: (recipient) => _startPayment(
-              context,
-              recipient: recipient,
-            ),
+            onRecipientSelected: (recipient) =>
+                _startPayment(context, recipient: recipient),
            onAddRecipient: () => _openAddRecipient(context),
            onEditRecipient: (recipient) =>
                _openEditRecipient(context, recipient: recipient),
@@ -329,8 +326,8 @@ RouteBase payoutShellRoute() => ShellRoute(
      path: PayoutRoutes.reportPaymentPath,
      pageBuilder: (_, state) => NoTransitionPage(
        child: PaymentDetailsPage(
-          paymentId: state.uri.queryParameters[
-                  PayoutRoutes.reportPaymentIdQuery] ??
+          paymentId:
+              state.uri.queryParameters[PayoutRoutes.reportPaymentIdQuery] ??
              '',
        ),
      ),
@@ -350,9 +347,7 @@ RouteBase payoutShellRoute() => ShellRoute(

        return NoTransitionPage(
          child: wallet != null
-              ? WalletEditPage(
-                  onBack: () => _popOrGo(context),
-                )
+              ? WalletEditPage(onBack: () => _popOrGo(context))
              : Center(child: Text(loc.noWalletSelected)),
        );
      },
@@ -361,11 +356,8 @@ RouteBase payoutShellRoute() => ShellRoute(
      name: PayoutRoutes.walletTopUp,
      path: PayoutRoutes.walletTopUpPath,
      pageBuilder: (context, state) {
-
        return NoTransitionPage(
-          child: WalletTopUpPage(
-            onBack: () => _popOrGo(context),
-          ),
+          child: WalletTopUpPage(onBack: () => _popOrGo(context)),
        );
      },
    ),
@@ -396,18 +388,12 @@ void _openEditRecipient(BuildContext context, {required Recipient recipient}) {
  context.pushNamed(PayoutRoutes.editRecipient);
 }

-void _openWalletEdit(
-  BuildContext context,
-  Wallet wallet,
-) {
+void _openWalletEdit(BuildContext context, Wallet wallet) {
  context.read<WalletsController>().selectWallet(wallet);
  context.pushToEditWallet();
 }

-void _openWalletTopUp(
-  BuildContext context,
-  Wallet wallet,
-) {
+void _openWalletTopUp(BuildContext context, Wallet wallet) {
  context.read<WalletsController>().selectWallet(wallet);
  context.pushToWalletTopUp();
 }
--- a/frontend/pweb/lib/controllers/payments/amount_field.dart
+++ b/frontend/pweb/lib/controllers/payments/amount_field.dart
@@ -1,6 +1,6 @@
 import 'package:flutter/material.dart';

-import 'package:pshared/controllers/balance_mask/wallets.dart';
+import 'package:pshared/controllers/payment/source.dart';
 import 'package:pshared/models/payment/settlement_mode.dart';
 import 'package:pshared/provider/payment/amount.dart';
 import 'package:pshared/utils/currency.dart';
@@ -15,7 +15,7 @@ class PaymentAmountFieldController extends ChangeNotifier {
  final FocusNode focusNode = FocusNode();

  PaymentAmountProvider? _provider;
-  WalletsController? _wallets;
+  PaymentSourceController? _source;
  bool _isSyncingText = false;
  PaymentAmountMode _mode = PaymentAmountMode.debit;

@@ -36,7 +36,7 @@ class PaymentAmountFieldController extends ChangeNotifier {
    PaymentAmountMode.settlement => _settlementCurrencyCode,
  };

-  void update(PaymentAmountProvider provider, WalletsController wallets) {
+  void update(PaymentAmountProvider provider, PaymentSourceController source) {
    if (!identical(_provider, provider)) {
      _provider?.removeListener(_handleProviderChanged);
      _provider = provider;
@@ -44,11 +44,11 @@ class PaymentAmountFieldController extends ChangeNotifier {
      _syncModeWithProvider(provider);
    }

-    if (!identical(_wallets, wallets)) {
-      _wallets?.removeListener(_handleWalletsChanged);
-      _wallets = wallets;
-      _wallets?.addListener(_handleWalletsChanged);
-      _normalizeModeForWallet();
+    if (!identical(_source, source)) {
+      _source?.removeListener(_handleSourceChanged);
+      _source = source;
+      _source?.addListener(_handleSourceChanged);
+      _normalizeModeForSource();
    }

    _syncTextWithAmount(provider.amount);
@@ -79,16 +79,14 @@ class PaymentAmountFieldController extends ChangeNotifier {
    _syncTextWithAmount(provider.amount);
    final changed = _syncModeWithProvider(provider);
    if (changed) {
-      _normalizeModeForWallet();
+      _normalizeModeForSource();
      notifyListeners();
    }
  }

-  void _handleWalletsChanged() {
-    final changed = _normalizeModeForWallet();
-    if (changed) {
-      notifyListeners();
-    }
+  void _handleSourceChanged() {
+    _normalizeModeForSource();
+    notifyListeners();
  }

  bool _syncModeWithProvider(PaymentAmountProvider provider) {
@@ -98,7 +96,7 @@ class PaymentAmountFieldController extends ChangeNotifier {
    return true;
  }

-  bool _normalizeModeForWallet() {
+  bool _normalizeModeForSource() {
    if (isReverseModeAvailable || _mode != PaymentAmountMode.settlement) {
      return false;
    }
@@ -108,9 +106,7 @@ class PaymentAmountFieldController extends ChangeNotifier {
  }

  String? get _sourceCurrencyCode {
-    final selectedWallet = _wallets?.selectedWallet;
-    if (selectedWallet == null) return null;
-    return currencyCodeToString(selectedWallet.currency);
+    return _source?.selectedCurrencyCode;
  }

  PaymentAmountMode _modeFromSettlementMode(SettlementMode mode) =>
@@ -150,7 +146,7 @@ class PaymentAmountFieldController extends ChangeNotifier {
  @override
  void dispose() {
    _provider?.removeListener(_handleProviderChanged);
-    _wallets?.removeListener(_handleWalletsChanged);
+    _source?.removeListener(_handleSourceChanged);
    focusNode.dispose();
    textController.dispose();
    super.dispose();
--- a/frontend/pweb/lib/l10n/en.arb
+++ b/frontend/pweb/lib/l10n/en.arb
@@ -610,6 +610,7 @@
      }
    }
  },
+   "noFee": "No fee",

  "recipientWillReceive": "Recipient will receive: {amount}",
  "@recipientWillReceive": {
--- a/frontend/pweb/lib/l10n/ru.arb
+++ b/frontend/pweb/lib/l10n/ru.arb
@@ -610,6 +610,7 @@
      }
    }
  },
+  "noFee": "Нет комиссии",

  "recipientWillReceive": "Получатель получит: {amount}",
  "@recipientWillReceive": {
--- a/frontend/pweb/lib/pages/dashboard/buttons/balance/controller.dart
+++ b/frontend/pweb/lib/pages/dashboard/buttons/balance/controller.dart
@@ -1,21 +1,124 @@
 import 'package:flutter/foundation.dart';

+import 'package:pshared/controllers/balance_mask/wallets.dart';
+import 'package:pshared/provider/ledger.dart';

-class CarouselIndexController with ChangeNotifier {
+import 'package:pweb/pages/dashboard/buttons/balance/balance_item.dart';
+
+class BalanceCarouselController with ChangeNotifier {
+  WalletsController? _walletsController;
+  List<BalanceItem> _items = const <BalanceItem>[BalanceItem.addAction()];
  int _index = 0;

+  List<BalanceItem> get items => _items;
  int get index => _index;

-  void setIndex(int value, int max) {
-    final next = value.clamp(0, max > 0 ? max - 1 : 0);
-    if (next == _index) return;
+  void update({
+    required WalletsController walletsController,
+    required LedgerAccountsProvider ledgerProvider,
+  }) {
+    _walletsController = walletsController;
+
+    final nextItems = <BalanceItem>[
+      ...walletsController.wallets.map(BalanceItem.wallet),
+      ...ledgerProvider.accounts.map(BalanceItem.ledger),
+      const BalanceItem.addAction(),
+    ];
+
+    final nextIndex = _resolveNextIndex(nextItems, walletsController);
+    final hasItemsChanged = !_isSameItems(_items, nextItems);
+    final hasIndexChanged = _index != nextIndex;
+
+    _items = nextItems;
+    _index = nextIndex;
+
+    if (hasItemsChanged || hasIndexChanged) {
+      notifyListeners();
+    }
+  }
+
+  void onPageChanged(int value) {
+    final next = _clampIndex(value, _items.length);
+    if (_index == next) {
+      _syncSelectedWallet();
+      return;
+    }
+
    _index = next;
+    _syncSelectedWallet();
    notifyListeners();
  }

-  void reset() {
-    if (_index == 0) return;
-    _index = 0;
-    notifyListeners();
+  void goBack() => onPageChanged(_index - 1);
+
+  void goForward() => onPageChanged(_index + 1);
+
+  int _resolveNextIndex(
+    List<BalanceItem> nextItems,
+    WalletsController walletsController,
+  ) {
+    final currentWalletRef = _currentWalletRef(_items, _index);
+    if (currentWalletRef != null) {
+      final byCurrentWallet = _walletIndexByRef(nextItems, currentWalletRef);
+      if (byCurrentWallet != null) return byCurrentWallet;
+
+      final selectedWalletRef = walletsController.selectedWalletRef;
+      final bySelectedWallet = _walletIndexByRef(nextItems, selectedWalletRef);
+      if (bySelectedWallet != null) return bySelectedWallet;
+    }
+
+    return _clampIndex(_index, nextItems.length);
+  }
+
+  String? _currentWalletRef(List<BalanceItem> items, int index) {
+    if (items.isEmpty || index < 0 || index >= items.length) return null;
+    final current = items[index];
+    if (!current.isWallet) return null;
+    return current.wallet?.id;
+  }
+
+  int? _walletIndexByRef(List<BalanceItem> items, String? walletRef) {
+    if (walletRef == null || walletRef.isEmpty) return null;
+    final idx = items.indexWhere(
+      (item) => item.isWallet && item.wallet?.id == walletRef,
+    );
+    if (idx < 0) return null;
+    return idx;
+  }
+
+  int _clampIndex(int value, int itemCount) {
+    if (itemCount <= 0) return 0;
+    return value.clamp(0, itemCount - 1);
+  }
+
+  bool _isSameItems(List<BalanceItem> left, List<BalanceItem> right) {
+    if (left.length != right.length) return false;
+
+    for (var i = 0; i < left.length; i++) {
+      final a = left[i];
+      final b = right[i];
+      if (a.type != b.type) return false;
+      if (_itemIdentity(a) != _itemIdentity(b)) return false;
+    }
+
+    return true;
+  }
+
+  String _itemIdentity(BalanceItem item) => switch (item.type) {
+    BalanceItemType.wallet => item.wallet?.id ?? '',
+    BalanceItemType.ledger => item.account?.ledgerAccountRef ?? '',
+    BalanceItemType.addAction => 'add',
+  };
+
+  void _syncSelectedWallet() {
+    final walletsController = _walletsController;
+    if (walletsController == null || _items.isEmpty) return;
+
+    final current = _items[_index];
+    if (!current.isWallet || current.wallet == null) return;
+
+    final wallet = current.wallet!;
+    if (walletsController.selectedWallet?.id == wallet.id) return;
+    walletsController.selectWallet(wallet);
  }
 }
--- a/frontend/pweb/lib/pages/dashboard/buttons/balance/providers.dart
+++ b/frontend/pweb/lib/pages/dashboard/buttons/balance/providers.dart
@@ -0,0 +1,31 @@
+import 'package:flutter/material.dart';
+
+import 'package:provider/provider.dart';
+
+import 'package:pshared/controllers/balance_mask/wallets.dart';
+import 'package:pshared/provider/ledger.dart';
+
+import 'package:pweb/pages/dashboard/buttons/balance/controller.dart';
+
+class BalanceWidgetProviders extends StatelessWidget {
+  final Widget child;
+
+  const BalanceWidgetProviders({super.key, required this.child});
+
+  @override
+  Widget build(BuildContext context) {
+    return ChangeNotifierProxyProvider2<
+      WalletsController,
+      LedgerAccountsProvider,
+      BalanceCarouselController
+    >(
+      create: (_) => BalanceCarouselController(),
+      update: (_, walletsController, ledgerProvider, controller) => controller!
+        ..update(
+          walletsController: walletsController,
+          ledgerProvider: ledgerProvider,
+        ),
+      child: child,
+    );
+  }
+}
--- a/frontend/pweb/lib/pages/dashboard/buttons/balance/balance.dart
+++ b/frontend/pweb/lib/pages/dashboard/buttons/balance/balance.dart
@@ -8,11 +8,9 @@ import 'package:pshared/models/payment/wallet.dart';

 import 'package:pweb/pages/dashboard/buttons/balance/carousel.dart';
 import 'package:pweb/pages/dashboard/buttons/balance/controller.dart';
-import 'package:pweb/pages/dashboard/buttons/balance/balance_item.dart';

 import 'package:pweb/generated/i18n/app_localizations.dart';

-
 class BalanceWidget extends StatelessWidget {
  final ValueChanged<Wallet> onTopUp;
  final ValueChanged<Wallet> onWalletTap;
@@ -27,12 +25,13 @@ class BalanceWidget extends StatelessWidget {
  Widget build(BuildContext context) {
    final walletsController = context.watch<WalletsController>();
    final ledgerProvider = context.watch<LedgerAccountsProvider>();
-    final carousel = context.watch<CarouselIndexController>();
+    final carousel = context.watch<BalanceCarouselController>();
    final loc = AppLocalizations.of(context)!;

    final wallets = walletsController.wallets;
    final accounts = ledgerProvider.accounts;
-    final isLoading = walletsController.isLoading &&
+    final isLoading =
+        walletsController.isLoading &&
        ledgerProvider.isLoading &&
        wallets.isEmpty &&
        accounts.isEmpty;
@@ -41,40 +40,10 @@ class BalanceWidget extends StatelessWidget {
      return const Center(child: CircularProgressIndicator());
    }

-    final items = [
-      ...wallets.map(BalanceItem.wallet),
-      ...accounts.map(BalanceItem.ledger),
-      const BalanceItem.addAction(),
-    ];
-
-    if (items.isEmpty) {
-      return const SizedBox.shrink();
-    }
-
-    // Ensure index is always valid when list changes
-    carousel.setIndex(carousel.index, items.length);
-
-    final index = carousel.index;
-    final current = items[index];
-
-    // Single source of truth: controller
-    if (current.isWallet) {
-      final wallet = current.wallet!;
-      if (walletsController.selectedWallet?.id != wallet.id) {
-        walletsController.selectWallet(wallet);
-      }
-    }
-
    final carouselWidget = BalanceCarousel(
-      items: items,
-      currentIndex: index,
-      onIndexChanged: (i) {
-        carousel.setIndex(i, items.length);
-        final next = items[carousel.index];
-        if (next.isWallet) {
-          walletsController.selectWallet(next.wallet!);
-        }
-      },
+      items: carousel.items,
+      currentIndex: carousel.index,
+      onIndexChanged: carousel.onPageChanged,
      onTopUp: onTopUp,
      onWalletTap: onWalletTap,
    );
--- a/frontend/pweb/lib/pages/dashboard/dashboard.dart
+++ b/frontend/pweb/lib/pages/dashboard/dashboard.dart
@@ -1,14 +1,12 @@
 import 'package:flutter/material.dart';

-import 'package:provider/provider.dart';
-
 import 'package:pshared/models/payment/type.dart';
 import 'package:pshared/models/recipient/recipient.dart';
 import 'package:pshared/models/payment/wallet.dart';

 import 'package:pweb/models/dashboard/dashboard_payment_mode.dart';
-import 'package:pweb/pages/dashboard/buttons/balance/balance.dart';
-import 'package:pweb/pages/dashboard/buttons/balance/controller.dart';
+import 'package:pweb/pages/dashboard/buttons/balance/widget.dart';
+import 'package:pweb/pages/dashboard/buttons/balance/providers.dart';
 import 'package:pweb/pages/dashboard/buttons/buttons.dart';
 import 'package:pweb/pages/dashboard/payouts/multiple/widgets/title.dart';
 import 'package:pweb/pages/dashboard/payouts/multiple/widget.dart';
@@ -17,7 +15,6 @@ import 'package:pweb/pages/loader.dart';

 import 'package:pweb/generated/i18n/app_localizations.dart';

-
 class AppSpacing {
  static const double small = 10;
  static const double medium = 16;
@@ -86,8 +83,7 @@ class _DashboardPageState extends State<DashboardPage> {
                ],
              ),
              const SizedBox(height: AppSpacing.medium),
-              ChangeNotifierProvider(
-                create: (_) => CarouselIndexController(),
+              BalanceWidgetProviders(
                child: BalanceWidget(
                  onTopUp: widget.onTopUp,
                  onWalletTap: widget.onWalletTap,
--- a/frontend/pweb/lib/pages/dashboard/payouts/amount/widget.dart
+++ b/frontend/pweb/lib/pages/dashboard/payouts/amount/widget.dart
@@ -2,7 +2,7 @@ import 'package:flutter/material.dart';

 import 'package:provider/provider.dart';

-import 'package:pshared/controllers/balance_mask/wallets.dart';
+import 'package:pshared/controllers/payment/source.dart';
 import 'package:pshared/provider/payment/amount.dart';

 import 'package:pweb/controllers/payments/amount_field.dart';
@@ -15,15 +15,15 @@ class PaymentAmountWidget extends StatelessWidget {
  Widget build(BuildContext context) {
    return ChangeNotifierProxyProvider2<
      PaymentAmountProvider,
-      WalletsController,
+      PaymentSourceController,
      PaymentAmountFieldController
    >(
      create: (ctx) {
        final initialAmount = ctx.read<PaymentAmountProvider>().amount;
        return PaymentAmountFieldController(initialAmount: initialAmount);
      },
-      update: (ctx, amountProvider, wallets, controller) {
-        controller!.update(amountProvider, wallets);
+      update: (ctx, amountProvider, source, controller) {
+        controller!.update(amountProvider, source);
        return controller;
      },
      child: const PaymentAmountField(),
--- a/frontend/pweb/lib/pages/dashboard/payouts/single/form/details.dart
+++ b/frontend/pweb/lib/pages/dashboard/payouts/single/form/details.dart
@@ -1,68 +0,0 @@
-import 'package:flutter/material.dart';
-
-import 'package:pshared/models/payment/methods/data.dart';
-import 'package:pshared/models/payment/type.dart';
-
-import 'package:pweb/pages/payment_methods/form.dart';
-
-import 'package:pweb/generated/i18n/app_localizations.dart';
-
-
-class PaymentDetailsSection extends StatelessWidget {
-  final bool isFormVisible;
-  final bool isEditable;
-  final VoidCallback? onToggle;
-  final PaymentType? selectedType;
-  final PaymentMethodData? data;
-
-  const PaymentDetailsSection({
-    super.key,
-    required this.isFormVisible,
-    this.onToggle,
-    required this.selectedType,
-    required this.data,
-    required this.isEditable,
-  });
-
-  static const double toggleSpacing = 8.0;
-  static const double formVisibleSpacing = 30.0;
-  static const double formHiddenSpacing = 20.0;
-  static const Duration animationDuration = Duration(milliseconds: 200);
-
-  @override
-  Widget build(BuildContext context) {
-    final theme = Theme.of(context);
-    final loc = AppLocalizations.of(context)!;
-
-    final toggleIcon = isFormVisible ? Icons.expand_less : Icons.expand_more;
-    final toggleText = isFormVisible ? loc.hideDetails : loc.showDetails;
-
-    return Column(
-      children: [
-        if (!isEditable && onToggle != null)
-          TextButton.icon(
-            onPressed: onToggle,
-            icon: Icon(toggleIcon, color: theme.colorScheme.primary),
-            label: Text(
-              toggleText,
-              style: TextStyle(color: theme.colorScheme.primary),
-            ),
-          ),
-        const SizedBox(height: toggleSpacing),
-        AnimatedCrossFade(
-          duration: animationDuration,
-          crossFadeState: isFormVisible ? CrossFadeState.showFirst : CrossFadeState.showSecond,
-          firstChild: PaymentMethodForm(
-            key: const ValueKey('formVisible'),
-            isEditable: isEditable,
-            selectedType: selectedType,
-            onChanged: (_) {},
-            initialData: data,
-          ),
-          secondChild: const SizedBox.shrink(key: ValueKey('formHidden')),
-        ),
-        SizedBox(height: isFormVisible ? formVisibleSpacing : formHiddenSpacing),
-      ],
-    );
-  }
-}
--- a/frontend/pweb/lib/pages/dashboard/payouts/single/form/header.dart
+++ b/frontend/pweb/lib/pages/dashboard/payouts/single/form/header.dart
@@ -1,32 +0,0 @@
-import 'package:flutter/material.dart';
-
-import 'package:pshared/models/recipient/recipient.dart';
-
-import 'package:pweb/pages/dashboard/payouts/single/address_book/avatar.dart';
-
-
-class RecipientHeader extends StatelessWidget{
-  final Recipient recipient;
-
-  const RecipientHeader({super.key, required this.recipient});
-
-  final double _avatarRadius = 20;
-
-  @override
-  Widget build(BuildContext context) {
-    final theme = Theme.of(context);
-
-    return ListTile(
-      contentPadding: EdgeInsets.zero,
-      leading: RecipientAvatar(
-        isVisible: false,
-        name: recipient.name,
-        avatarUrl: recipient.avatarUrl,
-        avatarRadius: _avatarRadius,
-        nameStyle: Theme.of(context).textTheme.bodyMedium,
-      ),
-      title: Text(recipient.name, style: theme.textTheme.titleLarge),
-      subtitle: Text(recipient.email, style: theme.textTheme.bodyLarge),
-    );
-  }
-}
--- a/frontend/pweb/lib/pages/dashboard/payouts/summary/fee.dart
+++ b/frontend/pweb/lib/pages/dashboard/payouts/summary/fee.dart
@@ -14,10 +14,15 @@ class PaymentFeeRow extends StatelessWidget {

  @override
  Widget build(BuildContext context) => Consumer<QuotationProvider>(
-    builder: (context, provider, _) => PaymentSummaryRow(
-      labelFactory: AppLocalizations.of(context)!.fee,
-      asset: provider.fee,
-      style: Theme.of(context).textTheme.titleMedium,
-    ),
+    builder: (context, provider, _) {
+      final fee = provider.fee;
+      final l10 = AppLocalizations.of(context)!;
+      return PaymentSummaryRow(
+        labelFactory: l10.fee,
+        asset: fee,
+        value: fee == null ? l10.noFee : null,
+        style: Theme.of(context).textTheme.titleMedium,
+      );
+    },
  );
 }
--- a/frontend/pweb/lib/pages/payout_page/send/body.dart
+++ b/frontend/pweb/lib/pages/payout_page/send/body.dart
@@ -1,7 +1,6 @@
 import 'package:flutter/material.dart';

 import 'package:pshared/models/recipient/recipient.dart';
-import 'package:pshared/models/payment/wallet.dart';
 import 'package:pshared/provider/recipient/pmethods.dart';
 import 'package:pshared/provider/recipient/provider.dart';

@@ -13,7 +12,6 @@ import 'package:pweb/models/state/visibility.dart';

 import 'package:pweb/generated/i18n/app_localizations.dart';

-
 class PaymentPageBody extends StatelessWidget {
  final ValueChanged<Recipient?>? onBack;
  final Recipient? recipient;
@@ -23,7 +21,6 @@ class PaymentPageBody extends StatelessWidget {
  final PaymentMethodsProvider methodsProvider;
  final ControlState sendState;
  final int cooldownRemainingSeconds;
-  final ValueChanged<Wallet> onWalletSelected;
  final PayoutDestination fallbackDestination;
  final TextEditingController searchController;
  final FocusNode searchFocusNode;
@@ -46,7 +43,6 @@ class PaymentPageBody extends StatelessWidget {
    required this.methodsProvider,
    required this.sendState,
    required this.cooldownRemainingSeconds,
-    required this.onWalletSelected,
    required this.fallbackDestination,
    required this.searchController,
    required this.searchFocusNode,
@@ -70,7 +66,9 @@ class PaymentPageBody extends StatelessWidget {

    if (methodsProvider.error != null) {
      return PaymentMethodsErrorView(
-        message: loc.notificationError(methodsProvider.error ?? loc.noErrorInformation),
+        message: loc.notificationError(
+          methodsProvider.error ?? loc.noErrorInformation,
+        ),
      );
    }

@@ -80,7 +78,6 @@ class PaymentPageBody extends StatelessWidget {
      recipientProvider: recipientProvider,
      searchQuery: searchQuery,
      filteredRecipients: filteredRecipients,
-      onWalletSelected: onWalletSelected,
      fallbackDestination: fallbackDestination,
      sendState: sendState,
      cooldownRemainingSeconds: cooldownRemainingSeconds,
--- a/frontend/pweb/lib/pages/payout_page/send/content.dart
+++ b/frontend/pweb/lib/pages/payout_page/send/content.dart
@@ -1,6 +1,5 @@
 import 'package:flutter/material.dart';

-import 'package:pshared/models/payment/wallet.dart';
 import 'package:pshared/models/recipient/recipient.dart';
 import 'package:pshared/provider/recipient/provider.dart';

@@ -13,14 +12,12 @@ import 'package:pweb/models/state/visibility.dart';

 import 'package:pweb/generated/i18n/app_localizations.dart';

-
 class PaymentPageContent extends StatelessWidget {
  final ValueChanged<Recipient?>? onBack;
  final Recipient? recipient;
  final RecipientsProvider recipientProvider;
  final String searchQuery;
  final List<Recipient> filteredRecipients;
-  final ValueChanged<Wallet> onWalletSelected;
  final PayoutDestination fallbackDestination;
  final ControlState sendState;
  final int cooldownRemainingSeconds;
@@ -42,7 +39,6 @@ class PaymentPageContent extends StatelessWidget {
    required this.recipientProvider,
    required this.searchQuery,
    required this.filteredRecipients,
-    required this.onWalletSelected,
    required this.fallbackDestination,
    required this.sendState,
    required this.cooldownRemainingSeconds,
@@ -79,7 +75,6 @@ class PaymentPageContent extends StatelessWidget {
        recipientProvider: recipientProvider,
        searchQuery: searchQuery,
        filteredRecipients: filteredRecipients,
-        onWalletSelected: onWalletSelected,
        fallbackDestination: fallbackDestination,
        sendState: sendState,
        cooldownRemainingSeconds: cooldownRemainingSeconds,
--- a/frontend/pweb/lib/pages/payout_page/send/content/sections.dart
+++ b/frontend/pweb/lib/pages/payout_page/send/content/sections.dart
@@ -1,6 +1,5 @@
 import 'package:flutter/material.dart';

-import 'package:pshared/models/payment/wallet.dart';
 import 'package:pshared/models/recipient/recipient.dart';
 import 'package:pshared/provider/recipient/provider.dart';

@@ -13,7 +12,6 @@ import 'package:pweb/widgets/sidebar/destinations.dart';
 import 'package:pweb/models/state/control_state.dart';
 import 'package:pweb/models/state/visibility.dart';

-
 class PaymentPageContentSections extends StatelessWidget {
  final AppDimensions dimensions;
  final String sourceOfFundsTitle;
@@ -22,7 +20,6 @@ class PaymentPageContentSections extends StatelessWidget {
  final RecipientsProvider recipientProvider;
  final String searchQuery;
  final List<Recipient> filteredRecipients;
-  final ValueChanged<Wallet> onWalletSelected;
  final PayoutDestination fallbackDestination;
  final ControlState sendState;
  final int cooldownRemainingSeconds;
@@ -46,7 +43,6 @@ class PaymentPageContentSections extends StatelessWidget {
    required this.recipientProvider,
    required this.searchQuery,
    required this.filteredRecipients,
-    required this.onWalletSelected,
    required this.fallbackDestination,
    required this.sendState,
    required this.cooldownRemainingSeconds,
@@ -77,7 +73,6 @@ class PaymentPageContentSections extends StatelessWidget {
        PaymentPageSourceSection(
          dimensions: dimensions,
          title: sourceOfFundsTitle,
-          onWalletSelected: onWalletSelected,
        ),
        SizedBox(height: dimensions.paddingXLarge),
        PaymentPageRecipientSection(
--- a/frontend/pweb/lib/pages/payout_page/send/content/source_section.dart
+++ b/frontend/pweb/lib/pages/payout_page/send/content/source_section.dart
@@ -1,29 +1,20 @@
 import 'package:flutter/material.dart';

-import 'package:pshared/models/payment/wallet.dart';
-
 import 'package:pweb/pages/payout_page/send/widgets/source_of_funds_card.dart';
 import 'package:pweb/utils/dimensions.dart';

-
 class PaymentPageSourceSection extends StatelessWidget {
  final AppDimensions dimensions;
  final String title;
-  final ValueChanged<Wallet> onWalletSelected;

  const PaymentPageSourceSection({
    super.key,
    required this.dimensions,
    required this.title,
-    required this.onWalletSelected,
  });

  @override
  Widget build(BuildContext context) {
-    return PaymentSourceOfFundsCard(
-      dimensions: dimensions,
-      title: title,
-      onWalletSelected: onWalletSelected,
-    );
+    return PaymentSourceOfFundsCard(dimensions: dimensions, title: title);
  }
 }
--- a/frontend/pweb/lib/pages/payout_page/send/page_view.dart
+++ b/frontend/pweb/lib/pages/payout_page/send/page_view.dart
@@ -2,7 +2,6 @@ import 'package:flutter/material.dart';

 import 'package:provider/provider.dart';

-import 'package:pshared/controllers/balance_mask/wallets.dart';
 import 'package:pshared/models/recipient/recipient.dart';
 import 'package:pshared/provider/payment/quotation/quotation.dart';
 import 'package:pshared/provider/recipient/pmethods.dart';
@@ -15,7 +14,6 @@ import 'package:pweb/controllers/payments/page_ui.dart';
 import 'package:pweb/controllers/payouts/payout_verification.dart';
 import 'package:pweb/models/state/control_state.dart';

-
 class PaymentPageView extends StatelessWidget {
  final PaymentPageUiController uiController;
  final ValueChanged<Recipient?>? onBack;
@@ -50,8 +48,8 @@ class PaymentPageView extends StatelessWidget {
          final methodsProvider = context.watch<PaymentMethodsProvider>();
          final recipientProvider = context.watch<RecipientsProvider>();
          final quotationProvider = context.watch<QuotationProvider>();
-          final verificationController =
-              context.watch<PayoutVerificationController>();
+          final verificationController = context
+              .watch<PayoutVerificationController>();
          final verificationContextKey =
              quotationProvider.quotation?.quoteRef ??
              quotationProvider.quotation?.idempotencyKey;
@@ -62,10 +60,10 @@ class PaymentPageView extends StatelessWidget {
          );
          final sendState =
              verificationController.isCooldownActiveFor(verificationContextKey)
-                  ? ControlState.disabled
-                  : (recipient == null
-                      ? ControlState.disabled
-                      : ControlState.enabled);
+              ? ControlState.disabled
+              : (recipient == null
+                    ? ControlState.disabled
+                    : ControlState.enabled);

          return PaymentPageBody(
            onBack: onBack,
@@ -76,10 +74,8 @@ class PaymentPageView extends StatelessWidget {
            filteredRecipients: filteredRecipients,
            methodsProvider: methodsProvider,
            sendState: sendState,
-            cooldownRemainingSeconds:
-                verificationController
-                    .cooldownRemainingSecondsFor(verificationContextKey),
-            onWalletSelected: context.read<WalletsController>().selectWallet,
+            cooldownRemainingSeconds: verificationController
+                .cooldownRemainingSecondsFor(verificationContextKey),
            searchController: uiController.searchController,
            searchFocusNode: uiController.searchFocusNode,
            onSearchChanged: onSearchChanged,
--- a/frontend/pweb/lib/pages/payout_page/send/widgets/method_selector.dart
+++ b/frontend/pweb/lib/pages/payout_page/send/widgets/method_selector.dart
@@ -2,25 +2,16 @@ import 'package:flutter/material.dart';

 import 'package:provider/provider.dart';

-import 'package:pshared/controllers/balance_mask/wallets.dart';
-import 'package:pshared/models/payment/wallet.dart';
+import 'package:pshared/controllers/payment/source.dart';

 import 'package:pweb/widgets/payment/source_wallet_selector.dart';

-
 class PaymentMethodSelector extends StatelessWidget {
-  final ValueChanged<Wallet> onMethodChanged;
-
-  const PaymentMethodSelector({
-    super.key,
-    required this.onMethodChanged,
-  });
+  const PaymentMethodSelector({super.key});

  @override
-  Widget build(BuildContext context) => Consumer<WalletsController>(
-        builder: (context, provider, _) => SourceWalletSelector(
-          walletsController: provider,
-          onChanged: onMethodChanged,
-        ),
-      );
+  Widget build(BuildContext context) => Consumer<PaymentSourceController>(
+    builder: (context, provider, _) =>
+        SourceWalletSelector(sourceController: provider),
+  );
 }
--- a/frontend/pweb/lib/pages/payout_page/send/widgets/source_of_funds_card.dart
+++ b/frontend/pweb/lib/pages/payout_page/send/widgets/source_of_funds_card.dart
@@ -2,26 +2,23 @@ import 'package:flutter/material.dart';

 import 'package:provider/provider.dart';

-import 'package:pshared/controllers/balance_mask/wallets.dart';
-import 'package:pshared/models/payment/wallet.dart';
+import 'package:pshared/controllers/payment/source.dart';

 import 'package:pweb/pages/payout_page/send/widgets/method_selector.dart';
 import 'package:pweb/pages/payout_page/send/widgets/section/title.dart';
 import 'package:pweb/pages/payout_page/send/widgets/section/card.dart';
 import 'package:pweb/utils/dimensions.dart';
+import 'package:pweb/widgets/refresh_balance/ledger.dart';
 import 'package:pweb/widgets/refresh_balance/wallet.dart';

-
 class PaymentSourceOfFundsCard extends StatelessWidget {
  final AppDimensions dimensions;
  final String title;
-  final ValueChanged<Wallet> onWalletSelected;

  const PaymentSourceOfFundsCard({
    super.key,
    required this.dimensions,
    required this.title,
-    required this.onWalletSelected,
  });

  @override
@@ -33,21 +30,29 @@ class PaymentSourceOfFundsCard extends StatelessWidget {
          Row(
            children: [
              Expanded(child: SectionTitle(title)),
-              Consumer<WalletsController>(
+              Consumer<PaymentSourceController>(
                builder: (context, provider, _) {
-                  final selectedWalletId = provider.selectedWallet?.id;
-                  if (selectedWalletId == null) {
-                    return const SizedBox.shrink();
+                  final selectedWallet = provider.selectedWallet;
+                  if (selectedWallet != null) {
+                    return WalletBalanceRefreshButton(
+                      walletRef: selectedWallet.id,
+                    );
                  }
-                  return WalletBalanceRefreshButton(walletRef: selectedWalletId);
+
+                  final selectedLedger = provider.selectedLedgerAccount;
+                  if (selectedLedger != null) {
+                    return LedgerBalanceRefreshButton(
+                      ledgerAccountRef: selectedLedger.ledgerAccountRef,
+                    );
+                  }
+
+                  return const SizedBox.shrink();
                },
              ),
            ],
          ),
          SizedBox(height: dimensions.paddingSmall),
-          PaymentMethodSelector(
-            onMethodChanged: onWalletSelected,
-          ),
+          const PaymentMethodSelector(),
        ],
      ),
    );
--- a/frontend/pweb/lib/widgets/payment/source_wallet_selector.dart
+++ b/frontend/pweb/lib/widgets/payment/source_wallet_selector.dart
@@ -1,42 +1,137 @@
 import 'package:flutter/material.dart';

 import 'package:pshared/controllers/balance_mask/wallets.dart';
+import 'package:pshared/controllers/payment/source.dart';
+import 'package:pshared/models/ledger/account.dart';
+import 'package:pshared/models/payment/source_type.dart';
 import 'package:pshared/models/payment/wallet.dart';
 import 'package:pshared/utils/currency.dart';
+import 'package:pshared/utils/money.dart';

 import 'package:pweb/generated/i18n/app_localizations.dart';


+typedef _SourceOptionKey = ({PaymentSourceType type, String ref});
+
 class SourceWalletSelector extends StatelessWidget {
  const SourceWalletSelector({
    super.key,
-    required this.walletsController,
+    this.walletsController,
+    this.sourceController,
    this.isBusy = false,
    this.onChanged,
-  });
+  }) : assert(
+         (walletsController != null) != (sourceController != null),
+         'Provide either walletsController or sourceController',
+       );

-  final WalletsController walletsController;
+  final WalletsController? walletsController;
+  final PaymentSourceController? sourceController;
  final bool isBusy;
  final ValueChanged<Wallet>? onChanged;

  @override
  Widget build(BuildContext context) {
-    final wallets = walletsController.wallets;
-    final selectedWalletRef = walletsController.selectedWalletRef;
+    final source = sourceController;
+    if (source != null) {
+      final selectedWallet = source.selectedWallet;
+      final selectedLedger = source.selectedLedgerAccount;
+      final selectedValue = switch (source.selectedType) {
+        PaymentSourceType.wallet =>
+          selectedWallet == null ? null : _walletKey(selectedWallet.id),
+        PaymentSourceType.ledger =>
+          selectedLedger == null
+              ? null
+              : _ledgerKey(selectedLedger.ledgerAccountRef),
+        null => null,
+      };
+
+      return _buildSourceSelector(
+        context: context,
+        wallets: source.wallets,
+        ledgerAccounts: source.ledgerAccounts,
+        selectedValue: selectedValue,
+        onChanged: (value) {
+          if (value.type == PaymentSourceType.wallet) {
+            source.selectWalletByRef(value.ref);
+            final selected = source.selectedWallet;
+            if (selected != null) {
+              onChanged?.call(selected);
+            }
+            return;
+          }
+
+          if (value.type == PaymentSourceType.ledger) {
+            source.selectLedgerByRef(value.ref);
+          }
+        },
+      );
+    }
+
+    final wallets = walletsController!;
+    return _buildSourceSelector(
+      context: context,
+      wallets: wallets.wallets,
+      ledgerAccounts: const <LedgerAccount>[],
+      selectedValue: wallets.selectedWalletRef == null
+          ? null
+          : _walletKey(wallets.selectedWalletRef!),
+      onChanged: (value) {
+        if (value.type != PaymentSourceType.wallet) return;
+        wallets.selectWalletByRef(value.ref);
+        final selected = wallets.selectedWallet;
+        if (selected != null) {
+          onChanged?.call(selected);
+        }
+      },
+    );
+  }
+
+  Widget _buildSourceSelector({
+    required BuildContext context,
+    required List<Wallet> wallets,
+    required List<LedgerAccount> ledgerAccounts,
+    required _SourceOptionKey? selectedValue,
+    required ValueChanged<_SourceOptionKey> onChanged,
+  }) {
    final theme = Theme.of(context);
    final l10n = AppLocalizations.of(context)!;

-    if (wallets.isEmpty) {
+    if (wallets.isEmpty && ledgerAccounts.isEmpty) {
      return Text(l10n.noWalletsAvailable, style: theme.textTheme.bodySmall);
    }

-    final effectiveSelectedWalletRef = selectedWalletRef != null &&
-            wallets.any((wallet) => wallet.id == selectedWalletRef)
-        ? selectedWalletRef
+    final items = <DropdownMenuItem<_SourceOptionKey>>[
+      ...wallets.map((wallet) {
+        return DropdownMenuItem<_SourceOptionKey>(
+          value: _walletKey(wallet.id),
+          child: Text(
+            '${wallet.name} - ${_walletBalance(wallet)}',
+            overflow: TextOverflow.ellipsis,
+          ),
+        );
+      }),
+      ...ledgerAccounts.map((ledger) {
+        return DropdownMenuItem<_SourceOptionKey>(
+          value: _ledgerKey(ledger.ledgerAccountRef),
+          child: Text(
+            '${ledger.name} - ${_ledgerBalance(ledger)}',
+            overflow: TextOverflow.ellipsis,
+          ),
+        );
+      }),
+    ];
+
+    final knownValues = items
+        .map((item) => item.value)
+        .whereType<_SourceOptionKey>()
+        .toSet();
+    final effectiveValue = knownValues.contains(selectedValue)
+        ? selectedValue
        : null;

-    return DropdownButtonFormField<String>(
-      initialValue: effectiveSelectedWalletRef,
+    return DropdownButtonFormField<_SourceOptionKey>(
+      initialValue: effectiveValue,
      isExpanded: true,
      decoration: InputDecoration(
        labelText: l10n.whereGetMoney,
@@ -46,48 +141,45 @@ class SourceWalletSelector extends StatelessWidget {
          vertical: 10,
        ),
      ),
-      items: wallets
-          .map(
-            (wallet) => DropdownMenuItem<String>(
-              value: wallet.id,
-              child: Text(
-                '${_walletLabel(wallet)} - ${currencyCodeToSymbol(wallet.currency)} ${amountToString(wallet.balance)}',
-                overflow: TextOverflow.ellipsis,
-              ),
-            ),
-          )
-          .toList(growable: false),
+      items: items,
      onChanged: isBusy
          ? null
          : (value) {
              if (value == null) return;
-              walletsController.selectWalletByRef(value);
-              final selected = walletsController.selectedWallet;
-              if (selected != null) {
-                onChanged?.call(selected);
-              }
+              onChanged(value);
            },
    );
  }

-  String _walletLabel(Wallet wallet) {
-    final description = wallet.description?.trim();
-    if (description != null && description.isNotEmpty) {
-      return description;
-    }
-    final name = wallet.name.trim();
-    if (name.isNotEmpty && !_looksLikeId(name)) {
-      return name;
-    }
-    final token = wallet.tokenSymbol?.trim();
-    if (token != null && token.isNotEmpty) {
-      return '$token wallet';
-    }
-    return '${currencyCodeToString(wallet.currency)} wallet';
+  _SourceOptionKey _walletKey(String walletRef) =>
+      (type: PaymentSourceType.wallet, ref: walletRef);
+
+  _SourceOptionKey _ledgerKey(String ledgerAccountRef) =>
+      (type: PaymentSourceType.ledger, ref: ledgerAccountRef);
+
+  String _walletBalance(Wallet wallet) {
+    final symbol = currencyCodeToSymbol(wallet.currency);
+    return '$symbol ${amountToString(wallet.balance)}';
  }

-  bool _looksLikeId(String value) {
-    return RegExp(r'^[a-f0-9]{12,}$', caseSensitive: false)
-        .hasMatch(value);
+  String _ledgerBalance(LedgerAccount account) {
+    final money = account.balance?.balance;
+    final rawAmount = money?.amount.trim();
+    final amount = parseMoneyAmount(rawAmount, fallback: double.nan);
+    final amountText = amount.isNaN
+        ? (rawAmount == null || rawAmount.isEmpty ? '--' : rawAmount)
+        : amountToString(amount);
+
+    final currencyCode = (money?.currency ?? account.currency)
+        .trim()
+        .toUpperCase();
+    final symbol = currencySymbolFromCode(currencyCode);
+    if (symbol != null && symbol.trim().isNotEmpty) {
+      return '$symbol $amountText';
+    }
+    if (currencyCode.isNotEmpty) {
+      return '$amountText $currencyCode';
+    }
+    return amountText;
  }
 }