> ## Documentation Index
> Fetch the complete documentation index at: https://docs.standalonetech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Wallet Dashboard

> How customers can manage their balance, view history, and perform transfers.

Customers can manage their wallet balance directly from their WooCommerce account page. TeraWallet seamlessly integrates a "My Wallet" tab into the customer dashboard.

### Dashboard Summary Cards

<Info>
  **New in 1.6.4.** A row of summary cards appears above the recent transactions list.
</Info>

When a customer opens **My Account → My Wallet**, they first see four at-a-glance cards:

* **Total top-ups** — everything the customer has added to their wallet.
* **Total spent** — both full wallet payments and partial payments.
* **Cashback earned** — shown only when the cashback reward program is enabled.
* **Available balance** — current spendable funds.

These figures share the same helper used by the admin user report, so the customer dashboard and the
admin screen always agree. Add-ons can register their own cards (for example "Total withdrawn") via
the `woo_wallet_dashboard_stat_cards` filter.

### Viewing Balance & Transactions

Customers can navigate to **My Account** > **My Wallet** to:

* **Check Current Balance**: The total available funds are displayed prominently.
* **View Transaction History**: A detailed table showing every credit and debit, along with dates and descriptions. The **Details** column wraps onto multiple lines so long descriptions stay readable on mobile.
* **Filter History**: Customers can use date range filters to audit their transaction history.

### Adding Funds (Top-up)

If the administrator has enabled top-ups, customers can add funds manually:

1. Go to the **My Wallet** tab.
2. Navigate to the **Top-up** sub-tab.
3. Enter the amount you wish to add.
4. Click **Add Balance**.
5. You will be redirected to the WooCommerce checkout page.
6. Complete the payment using any available gateway (e.g., Credit Card, PayPal).
7. Once the payment is processed, the funds are instantly credited to your wallet.

### Sending Funds (Transfer)

Customers can send funds to other registered users if transfers are enabled:

1. Navigate to the **Transfer** sub-tab within **My Wallet**.
2. Enter the recipient's **email address** (the email must be associated with a registered account on the site).
3. Specify the **amount** you want to send.
4. Add an optional **note** for the recipient.
5. Click **Transfer Now**.
6. The amount is instantly debited from your wallet and credited to the recipient's ledger.

### Shortcodes

You can display wallet information anywhere on your site using these shortcodes:

* `[woo-wallet]`: Displays the full wallet dashboard (recommended for a dedicated "My Wallet" page).
* `[mini-wallet]`: Shows a simple widget with the user's current balance, ideal for headers or sidebars.
* `[tw-sell-content]`: Renders the Sell Content action UI (when the Sell Content earning action is enabled).

<Tip>
  If you're using a page builder like Elementor or Gutenberg, you can insert the `[mini-wallet]` shortcode into your navigation menu for a personalized user experience.
</Tip>