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

# Cards

> View and manage issued cards — monitor balances, perform operations, and track transactions.

The **Cards** section of the CaaS Portal shows every card issued under your programs. Cards are created programmatically via the [V3.20 API](/v3.20/api-reference/cards/create) — the portal provides visibility, filtering, and manual operations for oversight and support.

## Card List

Navigate to **Cards** in the portal sidebar to see all cards for the active environment. Filter by:

| Filter         | Options                                            |
| -------------- | -------------------------------------------------- |
| **Status**     | `ACTIVE`, `FROZEN`, `TERMINATED`, `EXPIRED`        |
| **Card Type**  | `VIRTUAL`, `PHYSICAL`                              |
| **Program**    | Filter to a specific card program                  |
| **Cardholder** | Filter to cards belonging to a specific cardholder |
| **Search**     | Last 4 digits or masked PAN                        |

## Card Detail

Click a card to see its full detail view:

* **PAN** — masked card number (e.g. `4000 **** **** 1234`)
* **Expiry** — card expiry date
* **Brand** — Visa or Mastercard
* **Status** — current card status
* **Balance** — current card balance
* **Spending Limit** — card-level spending limit (if overridden)
* **Cardholder** — linked cardholder identity
* **Program** — the card program this card belongs to
* **Transaction History** — all authorizations, clearings, declines, and reversals

## Card Status

| Status         | Description                                                 |
| -------------- | ----------------------------------------------------------- |
| **Active**     | Card is operational and accepting transactions              |
| **Frozen**     | Card is temporarily blocked — no new transactions processed |
| **Terminated** | Card is permanently closed — irreversible                   |
| **Expired**    | Card has passed its expiry date                             |

## Card Operations

### Freeze & Unfreeze

Freezing temporarily blocks all new transactions on a card without terminating it. The card can be unfrozen at any time to resume normal operation.

**Use cases:** Lost card report, suspicious activity, cardholder request.

### Fund & Unload

| Operation  | Description                                                                                                |
| ---------- | ---------------------------------------------------------------------------------------------------------- |
| **Fund**   | Transfer USD from your program balance to the card. The cardholder can then spend up to the funded amount. |
| **Unload** | Return USD from the card back to the program balance.                                                      |

<Info>
  Card funding and unloading is reflected immediately in the card balance and generates a ledger transaction in your program account.
</Info>

### Terminate

Permanently closes the card. Any remaining balance is automatically unloaded back to the program balance before the card is terminated.

<Warning>
  Card termination is irreversible. Once terminated, a card cannot be reactivated. A replacement card must be issued if needed.
</Warning>

## Transactions

Each card's detail view includes a full transaction history:

| Field        | Description                                               |
| ------------ | --------------------------------------------------------- |
| **Type**     | `AUTHORIZATION`, `CLEARING`, `REVERSAL`, `DECLINE`, `FEE` |
| **Amount**   | Transaction amount (billing currency)                     |
| **Merchant** | Merchant name                                             |
| **Status**   | `AUTHORIZED`, `SETTLED`, `REVERSED`, `DECLINED`           |
| **Date**     | Authorization or settlement timestamp                     |

Transaction events are also delivered in real time via webhooks. See [Card Events](/v3.20/webhooks/events/card-events) for the full event reference.