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

# Transactions (Card Issuing)

> The merchant dashboard Cards > Transactions tab — view the card-transaction stream (authorizations, refunds, reversals, settlements, chargebacks) for all cards on the account, filterable by date / type / status / card number, with a per-transaction detail view and export. Distinct from the account-level Finance activity page.

## What this is

This is the top **Transactions** tab under the **Cards** module in the merchant dashboard (left nav **Cards** -> top tab **Transactions**; page title "Card transactions", subtitle "Card authorizations and settlements"). It shows the **card-transaction stream generated at the merchant side** for all cards on the account — every authorization, refund, reversal, settlement, and chargeback, with merchant info, transaction amount and billing amount (dual currency), and an Approved/Declined status. Use this page to check what a card was charged for, why a purchase was declined, or to export card-transaction detail.

> **Difference from Finance activity** (`/issuing/transactions`): this page is the **card's transaction record at the merchant side** (spend/authorization dimension, status Approved/Declined); Finance activity is the **funding account's money movement / ledger** (deposits, transfers, card recharges, fees, and other account-level fund changes, status Completed/Pending/Failed). They come from different data sources and use different definitions — don't conflate them.

## Steps

Open card transactions:

1. In the left nav, click **Cards**.
2. Select the **Transactions** tab at the top (siblings: Overview, Cards, Cardholders, Low balance).
3. The list shows the **last 3 months** of card transactions by default; use the filters at the top to narrow the range.

Filter:

1. **Date range** (leftmost): defaults to "last 3 months"; switch to another range or "All time" to see everything (slower with large volumes).
2. **Type**: check one or more transaction types (see table below).
3. **Status**: check Approved or Declined.
4. **Card number**: search by card number.
5. The **filtered by** tags at the top show the currently active filters; click the X on a tag to remove it, or **Clear all** to reset.

View a single transaction's detail: click the row's trailing **...** menu -> **View details**, which opens a transaction detail panel (transaction information, amount, merchant name / category code / city / country, timeline: transaction time / posted time, reason, etc.).

Export:

* Click **Export** in the top right to generate a card-transaction report.
* Or select multiple rows, then use **Export selected** in the batch-actions bar to export the selected records as CSV (**up to 100 rows per export**; exceeding this shows a warning).

## Fields and statuses

**List columns**:

| Column             | Meaning (merchant view)                                                                   |
| ------------------ | ----------------------------------------------------------------------------------------- |
| Reference          | Transaction reference number, copyable inline                                             |
| Type               | Transaction type (see enum below)                                                         |
| Card number        | The card the transaction occurred on (masked)                                             |
| Transaction amount | The actual transaction amount and currency                                                |
| Billing amount     | The amount posted to billing, and its currency (may differ from the transaction currency) |
| Merchant           | Merchant name + city, country                                                             |
| Time               | Transaction time                                                                          |
| Status             | Approved / Declined                                                                       |

**Transaction status**:

| Status   | Meaning                                                                        |
| -------- | ------------------------------------------------------------------------------ |
| Approved | The transaction went through                                                   |
| Declined | The transaction was declined; hover the status badge to see the decline reason |

**Transaction types** (filter options):

| Type                | Description                                |
| ------------------- | ------------------------------------------ |
| Authorization       | Card spend authorization                   |
| Refund              | Refund                                     |
| Reversal            | Reversal (undoes the original transaction) |
| Fund Collection     | Fund collection                            |
| ATM Deposit         | ATM deposit                                |
| Validation          | Card validation                            |
| Settlement Debit    | Settlement debit                           |
| Settlement Credit   | Settlement credit                          |
| Settlement Reversal | Settlement reversal                        |
| Chargeback Debit    | Chargeback debit                           |
| Chargeback Credit   | Chargeback credit                          |

> The list may show historical type badges outside the table above; the above are the options the filter panel provides.

## Edge cases and troubleshooting

* **List shows "No transactions yet"**: no cards under this account have any card transactions yet; the hint reads "Transactions will appear here once cards are used."
* **Filtered to "No transactions match your filters"**: the current date/type/status/card-number filters have no match — adjust or clear filters and check again.
* **Only seeing the last 3 months by default**: this is the default date range (for performance on large tables); to see earlier data, change the date to "All time" or a specific earlier range.
* **A transaction shows "Declined" and you want the reason**: hover over that row's status badge to see the decline reason.
* **Export selected is empty / can't select more**: up to 100 rows per export; batch select and export operate on the currently loaded page — exceeding the cap triggers a warning.
* **Why a specific transaction was declined / a card's real-time balance**: these are account real-time / case-specific questions outside this page's static knowledge scope, and require a real-time query capability.

## Common questions (Q\&A)

* **Q: Where do I see card transactions? / How do I check what a specific card was charged for?** A: Left nav **Cards** -> top **Transactions** tab; use the **Card number** filter to locate a specific card's transactions.
* **Q: What's the difference between the Transactions tab and Finance activity?** A: The **Transactions** tab is card-side spend transactions (authorizations/refunds/chargebacks, status Approved/Declined); Finance activity is the funding account's money movement (recharges, transfers, fees, etc.).
* **Q: Why does it only show the last 3 months by default? How do I see older data?** A: The default date range is the last 3 months; change the date filter to "All time" or an earlier range.
* **Q: A transaction was declined — how do I see the reason?** A: Hover over that row's "Declined" status badge to see the decline reason.
* **Q: What's the difference between transaction amount and billing amount?** A: Transaction amount is the actual transaction amount; billing amount is the amount posted to billing — the two may be in different currencies.
* **Q: How do I export card transactions?** A: Click **Export** in the top right to generate a report; or select rows and use **Export selected** to export a CSV (up to 100 rows per export).
* **Q: What card-transaction types are there?** A: Authorization, Refund, Reversal, Fund Collection, ATM Deposit, Validation, Settlement Debit/Credit/Reversal, Chargeback Debit/Credit.
* **Q: How do I search transactions by card number?** A: Enter the card number in the **Card number** search box at the top.