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

# Finance Activity (Card Issuing Funding / Ledger Activity)

> The merchant dashboard card issuing Finance activity page — view the funding account's money movement / ledger (deposits, transfers in/out, card recharges, card withdrawals, fees, refunds, etc.), with a total-in / total-out / net and status stats bar, filterable by date / type / status / currency / reference / card number. Distinct from the card-spend stream on the Transactions tab.

## What this is

This is the **Finance activity** page in the card issuing module of the merchant dashboard (top title "Finance activity", subtitle "Funding, balance, and ledger activity"; the page itself is labeled "Finance Transactions — Funding, balance, and ledger activity across your issuing account"). It shows the **issuing account balance's money movement / ledger** — deposits, transfers between accounts, card recharges, card withdrawals, fees, refunds, and other **account-level fund changes**, with a total-in / total-out / net and total-count stats bar at the top. Use this page to reconcile account fund movement, look up a recharge or fee, or view fund flow by currency.

> **How to get here**: this page **has no dedicated top tab** — open it by clicking **View all** on an activity/balance card on the **Cards > Overview** page; you can also jump in from an Overview balance card with a currency parameter (automatically filtered to that currency).
>
> **Difference from the Transactions tab** (`/issuing/card-transactions`): this page is the **funding account's money movement** (fund in/out dimension, status Completed/Pending/Failed); the Transactions tab is **card-spend transactions at the merchant side** (spend/authorization dimension, status Approved/Declined). They come from different data sources and use different definitions — don't conflate them.

## Steps

Open Finance activity:

1. In the left nav, click **Cards** -> open **Overview**.
2. Click **View all** on a balance / activity card to open the Finance activity list.
3. The list shows the **last 3 months** of money movement by default.

Filter:

1. **Date range** (leftmost): defaults to "last 3 months"; switch to "All time" to see everything.
2. **Type**: check one or more transaction types (see table below).
3. **Status**: Completed / Pending / Failed (single select).
4. **Currency**: only lists currencies the account actually holds; **when exactly 1 currency is selected**, the top stats bar shows total-in/total-out/net amounts.
5. **Reference**: search by reference ID.
6. **Card number**: search by card number.
7. The **filtered by** area at the top shows the active filters, removable individually or via **Clear all**.

View a single transaction's detail: click anywhere in the row, or its trailing **...** -> **View details**, to open the transaction detail panel (transaction information, card number, merchant name, source/destination, reason, timeline, etc.).

Export: click **Export** in the top right to generate an account report; select rows and use **Export selected** to export a CSV.

## Fields and statuses

**Top stats bar** (reflects the current filters, not paginated):

| Metric                       | Meaning                                                                     |
| ---------------------------- | --------------------------------------------------------------------------- |
| Total In                     | Sum of credit amounts (shown only when exactly one currency is selected)    |
| Total Out                    | Sum of debit amounts (shown only when exactly one currency is selected)     |
| Net                          | Total In minus Total Out (shown only when exactly one currency is selected) |
| Total                        | The total count of transactions matching the filters                        |
| Completed / Pending / Failed | Counts by status                                                            |

**List columns**:

| Column    | Meaning                                              |
| --------- | ---------------------------------------------------- |
| Reference | Transaction reference number, copyable inline        |
| Type      | Transaction type (see enum below)                    |
| Amount    | Signed, with currency; `+` for credit, `-` for debit |
| Remark    | The transaction's remark                             |
| Time      | The transaction's creation time                      |
| Status    | Completed / Pending / Failed                         |

**Transaction status**:

| Status    | Meaning                     |
| --------- | --------------------------- |
| Completed | The transaction is complete |
| Pending   | Processing                  |
| Failed    | The transaction failed      |

**Transaction types** (filter options):

| Type          | Description                   |
| ------------- | ----------------------------- |
| Deposit       | Account deposit               |
| Transfer In   | Transfer in between accounts  |
| Transfer Out  | Transfer out between accounts |
| Authorization | Card authorization charge     |
| Reversal      | Reversal                      |
| Card Refund   | Card transaction refund       |
| Card Recharge | Recharge to a card            |
| Card Withdraw | Withdraw from a card          |
| Fee           | Fee                           |
| Refund        | Refund                        |

> Beyond the options above, the account ledger may also show historical type tags such as Settlement Debit/Credit, Chargeback Debit/Credit, Adjustment, Funds Transfer In/Out, and Margin Payment/Refund.

## Edge cases and troubleshooting

* **List shows "No transactions yet"**: the account has no money movement yet; the hint reads "Transactions will appear here once activity begins."
* **Filtered to "No transactions match your filters"**: adjust or clear filters and check again.
* **The stats bar doesn't show Total In/Out/Net amounts**: amounts only show when the currency filter has **exactly 1 currency selected** (summing across currencies is meaningless, so it's hidden); showing only Total/Completed/Pending/Failed counts is normal.
* **Only seeing the last 3 months by default**: this is the default date range — change to "All time" or an earlier range to see history.
* **Load-failure hints**: a failed fetch shows a "Failed to load" prompt rather than an empty state — refresh or retry later.
* **Arriving from Overview with a currency**: entering from an Overview balance card auto-filters to that currency; currencies the account doesn't hold are automatically excluded.
* **Why a specific fund movement hasn't posted / a real-time balance**: these are real-time / case-specific questions outside this page's static knowledge scope.

## Common questions (Q\&A)

* **Q: Where do I see the issuing account's money movement / ledger?** A: Left nav **Cards** -> **Overview** -> click **View all** on an activity/balance card to open Finance activity.
* **Q: What's the difference between Finance activity and the Transactions tab?** A: Finance activity is the funding account's money movement (recharges, transfers, fees, etc., status Completed/Pending/Failed); the **Transactions** tab is card-spend transactions at the merchant side (authorizations/refunds/chargebacks, status Approved/Declined).
* **Q: Why doesn't the stats bar show total-in/total-out amounts?** A: Amounts only show when the currency filter has exactly one currency selected; with none or multiple selected, only counts by status are shown.
* **Q: What do the + and - before the amount mean?** A: `+` is credit (funds in), `-` is debit (funds out).
* **Q: How do I look up a specific recharge/fee/transfer?** A: Use the **Type** filter to select "Card Recharge/Fee/Transfer In/Transfer Out" etc., or search by reference ID or card number.
* **Q: What transaction types appear in Finance activity?** A: Deposit, Transfer In, Transfer Out, Authorization, Reversal, Card Refund, Card Recharge, Card Withdraw, Fee, Refund (the account ledger may also show Settlement, Chargeback, Adjustment, and similar types).
* **Q: What does the "Pending" status mean?** A: That fund movement is still being processed and hasn't completed yet.
* **Q: How do I export the account ledger?** A: Click **Export** in the top right to generate a report; or select rows and use **Export selected** to export a CSV.