> ## 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.

# Card Ledger

> The merchant dashboard Card Ledger page — view a card's balance-change entries one by one (begin balance -> amount -> end balance), filterable by type / status / reference ID / card number / date range, with export.

## What this is

This is the **Card Ledger** page under the card issuing module in the merchant dashboard (usually opened from a card's **...** menu -> **View Card Ledger**; can also be reached directly at `/issuing/card-ledger`). The ledger records a card's **balance changes** entry by entry: each row has a begin balance, this entry's amount, and an end balance, used for card-level reconciliation and statement checking. Use this page to verify how a specific card's balance moved, whether a charge/refund posted, or to look up an entry by reference or card number.

## Steps

Open the card ledger:

1. From a card's **...** menu on the **Cards** page, select **View Card Ledger** to open that card's ledger; or go directly to the ledger page to see all entries.
2. When opened from a specific card, a **Route card** filter tag appears at the top, indicating you are viewing only that card.

Filter and search:

1. Use the **Type** filter to filter by transaction type (single select).
2. Use the **Status** filter to filter by transaction status (Approved / Declined).
3. Use the **Reference ID** search box to search by reference number (recent searches remembered).
4. Use the **Card number** search box to search by card number (non-digit characters are ignored automatically).
5. Use **Date range** to filter by time period.
6. Active filters appear as filter tags; click **Clear all** to reset.

Export:

1. Click **Export** in the toolbar to generate a ledger report via the report dialog.
2. Or select rows, then click **Export selected** in the selection bar to export the chosen entries as CSV.

## Fields and statuses

**List columns**:

| Column        | Meaning (merchant view)                                                                                                                |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Reference ID  | The ledger entry's reference number (can be copied inline); creation time shown below                                                  |
| Card          | Card number, with card name shown below (if any)                                                                                       |
| Type          | Transaction type (see below), badge colored by direction                                                                               |
| Begin balance | The card's balance before this change, plus currency                                                                                   |
| Amount        | The amount of this change; credits in green with "+", debits in red; if the billing currency differs, the billing amount is also shown |
| End balance   | The card's balance after this change, plus currency                                                                                    |
| Status        | Transaction status (see below); remark shown below (if any)                                                                            |

**Transaction status** (filter options):

| Status   | Meaning                      |
| -------- | ---------------------------- |
| Approved | The transaction was approved |
| Declined | The transaction was declined |

**Transaction types** (Type filter options; badge color by fund direction: credit green / debit orange / neutral gray):

| Type                | Direction |
| ------------------- | --------- |
| Deposit             | Credit    |
| Transfer In         | Credit    |
| Transfer Out        | Debit     |
| Authorization       | Debit     |
| Reversal            | Credit    |
| Card Refund         | Credit    |
| Fund Collection     | Credit    |
| Card Recharge       | Debit     |
| Card Withdraw       | Credit    |
| Fee                 | Debit     |
| Refund              | Credit    |
| Adjustment          | Neutral   |
| Settlement Debit    | Debit     |
| Settlement Credit   | Credit    |
| Settlement Reversal | Neutral   |
| Chargeback Debit    | Debit     |
| Chargeback Credit   | Credit    |
| Funds Transfer In   | Neutral   |
| Funds Transfer Out  | Neutral   |
| Fee Refund          | Neutral   |
| Fee Deduction       | Neutral   |
| Margin Payment      | Neutral   |
| Margin Refund       | Neutral   |
| Other               | Neutral   |

> The ledger's type vocabulary is more granular than the Overview page's (e.g. Overview shows "Card Recharge" where the ledger shows "Deposit" for the same event); rely on what each page actually displays.

## Edge cases and troubleshooting

* **List shows "No ledger entries yet"**: this card has no balance changes yet; the hint reads "Card balance changes will appear here."
* **Filtered to "No entries match your filters"**: the current filters have no match; the hint reads "Try adjusting your filter criteria." — clear filters and check again.
* **A "Route card" tag appears at the top**: you entered from a specific card and are viewing only that card; clear the filter to see a broader range (if permitted).
* **An extra amount in parentheses below the amount**: the billing currency differs from the transaction currency; the amount in parentheses is the billing-currency amount.
* **Loading / refresh hints**: on first load it shows "Loading ledger entries..."; during a background refresh it shows "Refreshing ledger entries..." at the bottom.
* **Can't find by card number**: the card number search automatically strips non-digit characters and matches on digits only; input with spaces or masking also works.
* **List shows red error text**: data failed to load; the error message is shown directly in the table area — retry later.

## Common questions (Q\&A)

* **Q: Where do I find a card's ledger? / How do I check a card's transaction history?** A: On the **Cards** page, open a card's **...** menu and select **View Card Ledger** to open that card's ledger.
* **Q: What's the difference between the ledger and card transactions?** A: The ledger is an entry-by-entry record of a card's **balance changes** (with begin/end balance for reconciliation); card transactions are more focused on authorization/settlement detail.
* **Q: How do I read begin balance, amount, and end balance?** A: End balance = begin balance +/- this entry's amount; each row is a before/after snapshot of one balance change.
* **Q: How do I look up a ledger entry by reference or card number?** A: Use the **Reference ID** or **Card number** search box at the top.
* **Q: What do the ledger statuses "Approved" and "Declined" mean?** A: Approved = the transaction went through; Declined = it was rejected.
* **Q: How do I export the card ledger?** A: Click **Export** in the toolbar to generate a ledger report via the dialog, or select rows and click **Export selected** to export a CSV.
* **Q: Why does the amount show two numbers (one in parentheses)?** A: The transaction currency and billing currency differ; the parenthesized number is the billing-currency amount.
* **Q: What are "Deposit" and "Card Recharge" in the type list?** A: They're all balance-change transaction types — credits (green) like Deposit / Transfer In / Refund, and debits (orange) like Authorization / Card Recharge / Fee.
* **Q: I only want to see one card's ledger — how?** A: Open that card's **...** menu -> **View Card Ledger**; the top will show a **Route card** tag limiting the view to that card.