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

# Card Management and Events

> Navigate the Cards, Card Events, and Card Products lists in the Treasury Prime Console, and review card details, card authorization and settlement events, and card product configurations.

## Prerequisites

To review cards, card events, and card products, you need:

* Access to the Treasury Prime Console with any Banker role
* A program at your bank that issues cards

## About the card pages

The Treasury Prime Console provides three card-related pages in the **Payments** area:

* **Cards:** Every card issued across your bank's programs, with each card's status and card product.
* **Card Events:** The authorization, settlement, and decline events generated by card transactions.
* **Card Products:** The card product configurations that define how cards are issued.

## Cards

### View the Cards list

1. Log into the Treasury Prime Console
2. Click **Payments** in the left navigation menu
3. Select **Cards** from the payments submenu

The **Cards** list shows every card across your bank's programs. Each row includes:

* **Card:** The card's last four digits, the cardholder name, and the card ID (e.g., card\_1234567890abcde).
* **Account:** The account holder, the linked account number, and the program the card belongs to.
* **Status:** The card's current state, such as **Active**.
* **Card Product:** The card product the card was issued under.
* **Created:** The date and time the card was created.

Narrow the list using the **All Sources** (the program), **All Statuses**, and **All Card Products** filters, and the **Created** date filter above the table. To jump directly to a card, click the **Search** icon (magnifying glass) in the top right corner and enter the card ID.

### View a card

Click a card in the **Cards** list to open its detail page. The card's status appears in the top right corner, and the page is organized into the following tabs:

* **Overview:** The cardholder name, card attributes (such as **Debit**, **Virtual**, and PIN status), last four digits, expiration date, and creation and update dates. A **Recent Events** list shows the card's most recent events with a **View all** link, and **Fulfillment Options** shows physical card fulfillment details.
* **Card Controls:** The spending and usage controls configured for the card.
* **Card Events:** The authorization, settlement, and decline events for this specific card.
* **Digital Wallet Tokens:** The digital wallet tokens provisioned for the card, such as those added to a mobile wallet.

### Change a card's status

Change a card's status to suspend a card, reactivate a suspended card, or terminate a card. The status appears in the top right corner of the card detail page. When your role can edit cards, a **View actions** control appears next to that status. Without that access, the status is visible and cannot be changed.

1. Find the card in the **Cards** list or with the global search, then click it to open its detail page
2. Click **View actions** next to the status in the top right corner
3. Select the new status:
   * **Suspend card** to suspend an active card
   * **Terminate card** to permanently terminate an active or suspended card
   * **Activate card** to reactivate a suspended card
4. Confirm the action in the dialog:
   * **Yes, suspend card**
   * **Yes, terminate card**
   * **Yes, activate card**

The menu only lists transitions that are valid for the card's current status:

* **Active** cards can be suspended or terminated.
* **Suspended** cards can be reactivated or terminated.
* **Unactivated** and **Terminated** cards have no **View actions** control. The Treasury Prime Console does not change an unactivated card's status, and a terminated card cannot be moved to another status.

**Note:** Terminating a card is permanent and cannot be undone. Suspend a card instead if you may need to reactivate it later.

## Card Events

### View the Card Events list

1. Click **Payments** in the left navigation menu
2. Select **Card Events** from the payments submenu

The **Card Events** list shows card authorization, settlement, and decline events across your bank's programs. Each row includes:

* **Event ID:** The card event ID (e.g., cnm\_1234567890abcde) and the event type, such as `auth-request`, `auth-reversal`, or `auth-clear-request`.
* **Card ID:** The card that generated the event.
* **Amount:** The transaction amount.
* **Merchant:** The merchant associated with the event.
* **Status:** The event outcome, such as **Approved**, **Denied**, or **Received**.
* **Created At:** The date and time the event was created.

Narrow the list using the **All Sources** (the program), **All Statuses**, and **All Networks** filters, and the **Created** date filter above the table.

### View a card event

Click an event in the **Card Events** list to open its detail page. The event status appears in the top right corner, and the page is organized into the following sections:

* **Summary header:** The cardholder, amount, event type, source program, the card that generated the event, and creation and update dates.
* **Spending Account:** The account funding the transaction, including account holder, account and routing numbers, and account ID.
* **Merchant Details:** Information about the merchant, including name, address, MCC (merchant category code), and MID (merchant ID).
* **Card Event Details:** Identifying details for the event, including the card event ID and card ID.

### Release a hold

A card authorization places a hold on the funds in the cardholder's account. These appear in the **Related Transactions** table with a **Type** of **Hold**. Releasing the hold makes the funds available in the account.

1. Open the card event detail page
2. In the **Related Transactions** table, find the row with a **Type** of **Hold**
3. Click **View actions** on that row
4. Select **Release Hold**
5. In the **Release Hold** dialog, click **Yes, release hold**

## Card Products

A card product is the configuration that cards are issued under. It defines how a set of cards is created, including the card type (physical or virtual), the card issuer, and security settings such as 3D Secure. Every card is tied to a card product.

### View the Card Products list

1. Click **Payments** in the left navigation menu
2. Select **Card Products** from the payments submenu

The **Card Products** list shows the card products configured for your bank's programs. Each row includes:

* **Name:** The card product name and its card product ID (e.g., cdpt\_1234567890abcde).
* **Type:** Whether the product issues **Physical** or **Virtual** cards.
* **Issuer:** The card issuer, such as Marqeta.
* **3D Secure:** The 3D Secure configuration for the product.
* **Status:** The card product's current state, such as **Active**.
* **Created:** The date the card product was created.

Narrow the list using the **All Types** and **All Statuses** filters, and the **Created** date filter above the table.

### View a card product

Click a card product in the **Card Products** list to open its detail page. The detail page summarizes the product's configuration, including its name, issuer, 3D Secure setting, type, status, and creation and last updated dates.

## Troubleshooting

Common issues and solutions:

* **A card or event does not appear in a list:** Adjust or clear the filters, including the **Created** date filter, which may exclude recent or older records. Confirm you are on the correct page for the record you are looking for (**Cards** or **Card Events**).
* **Cannot find a specific card or event:** Use the global search (the magnifying glass in the top right corner) with the exact card or event ID.
* **Card product configuration appears incorrect:** The card product detail page shows the same core configuration as the **Card Products** list. Contact Treasury Prime support if a product's configuration looks wrong.

> [!NOTE]
>
> For additional assistance with cards or Console functionality, contact Treasury Prime support through your designated support channels.
