---
updatedAt: 2026-11-12T20:09:32.000Z
agentTools:
  projectIndex: https://dev.kevel.com/llms.txt
---

# Wallets in Console

For media owner admins: create, fund and refund wallets, see each wallet's balance history, and see how advertisers book with one.

A wallet caps how much an advertiser can spend with you. It is a spending limit on credit, not prepaid money: the advertiser spends against the limit, and you fund the wallet to give them more room. Console has two views of wallets. Media owners create and manage every advertiser's wallets. Advertisers see their own wallets in read-only form and choose one when they book on a placement that requires it.

<Callout icon="🚧" theme="warn">
  ### Availability

  The **Wallets** menu item appears only where Kevel has turned wallets on for your business manager. Kevel turns it on separately for media owner users and for advertiser users. A placement asks for a wallet only where Kevel has set it up that way. Contact your Kevel representative to turn wallets on or to change which placements need one.
</Callout>

## How it works

Each wallet has three numbers.

| Number           | What it is                                                                                         |
| ---------------- | -------------------------------------------------------------------------------------------------- |
| **Credit Limit** | The most the wallet can spend. A limit of 0 means spend is allowed only once the wallet is funded. |
| **Available**    | The Credit Limit minus what has been spent. It can go negative.                                    |
| **Amount Owed**  | What has been spent beyond what you have funded, never below zero.                                 |

Funding a wallet does not add money. It lowers the balance, which gives the wallet more room, so Available goes up by the amount. A refund does the opposite. For example, a wallet with a limit of 0 that you fund with 5,000 has 5,000 available and nothing owed. After 5,200 of spend it has 200 owed, and Available is -200.

A wallet shows one of four statuses.

| Status          | When                                                                                                  |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Active**      | The wallet is on and has room to spend                                                                |
| **Low**         | The wallet has a **Notification threshold**, and Available is at or below it                          |
| **Capped**      | Spend has reached the Credit Limit. A new wallet with a limit of 0 reads **Capped** until you fund it |
| **Deactivated** | The wallet is switched off, whatever its balance                                                      |

Campaigns that use a wallet stop when the wallet is capped, and a campaign can run a little past the limit, because limits are enforced in cycles rather than on every ad. Funding a wallet, or raising its limit, lets campaigns serve again after the next cycle.

## Media owner and advertiser views

|                                            | Media owners                                          | Advertisers                                                                                 |
| ------------------------------------------ | ----------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Wallets they see**                       | Every advertiser's wallets                            | Their own wallets                                                                           |
| **Create, edit, fund, refund, deactivate** | Yes, with the Admin role                              | No                                                                                          |
| **Balance history and adjustments**        | One wallet at a time, from the chart icon on each row | One chart and one **Adjustments** table under the list, for the wallets on the current page |
| **Wallet field when booking**              | Yes, on placements that need a wallet                 | Yes, on placements that need a wallet                                                       |

## Before you start

**Where it applies.** The **Wallets** page in each view, and the **Wallet** field on the booking flow for placements that need one.

**What you need.** The Admin role to create, edit, fund or refund a wallet. Enter whole numbers for the limit and the threshold.

**What it does not do.**

* **It does not check the balance when an advertiser books.** An advertiser can book a campaign on a wallet that has no room left, and the wallet then caps its spend. To stop a wallet being used, deactivate it.
* **It does not delete wallets.** Deactivate a wallet to take it out of use. Deactivated wallets do not appear in the booking flow.
* **It does not change currency.** A wallet's currency is fixed when you create it. To use another currency, create a new wallet.
* **It does not work with flat-rate Flights.** A Campaign that is linked to a wallet cannot have a flat-rate Flight. A wallet cannot be linked to a Campaign that has one. Console offers only CPC and CPM, so this affects Flights created in the Ad Server UI or the API. See [Flat-rate Flights](https://dev.kevel.com/docs/flat-rate-flights#defaults-and-scope).

## Media owner view

Media owners see every advertiser's wallets on the **Wallets** page and manage them there.

### Create a wallet

Only media owner users with the Admin role can create a wallet. Advertisers cannot create their own: they choose from the wallets you create for them. The wallet belongs to one advertiser, and you choose which when you create it.

1. **Open Wallets.** Select **Wallets** in the sidebar, then select **Create new wallet**.
2. **Choose the advertiser.** Search by name or ID. The wallet fields appear after you choose one.
3. **Fill in the details.** Use the fields in the table below.
4. **Select Create new wallet.** Console confirms with a message such as Wallet "Spring credit" created.

| Field                                 | What to enter                                                                                |
| ------------------------------------- | -------------------------------------------------------------------------------------------- |
| **Wallet name**                       | Required. Up to 255 characters                                                               |
| **Limit**                             | Required. Zero or more. Zero allows spend only once you fund the wallet                      |
| **Notification threshold (optional)** | The available amount at which Console warns about a low balance. Leave it empty for no alert |
| **External ID (optional)**            | A reference such as a purchase order number                                                  |
| **Currency**                          | Choose from the currencies of the advertiser's campaign templates                            |

<Image align="center" border={false} width="90%" src="https://files.readme.io/5ea85f8810d727b3ce9c3befbcac507ed492385dabafc866011a31782fa69426-wallets-history-01-overview.png" alt="The Wallets page for a media owner. The Wallets overview list shows four wallets with Active, Low, Capped and Deactivated statuses, with the Status column highlighted. Each row ends with a chart icon and a menu." />

### Fund or refund a wallet

1. **Open the row menu.** In the **Wallets overview** list, open the actions menu for the wallet.
2. **Select Fund or Refund.** The dialog shows the wallet, the advertiser and the current available balance.
3. **Enter the amount and an optional note.** The amount must be greater than 0. Type it without thousands separators. The note is kept with the adjustment.
4. **Confirm.** Select **Fund** or **Refund** in the dialog. Console confirms "Successfully funded wallet" or "Successfully refunded wallet", with the wallet's name.

<Image align="center" border={false} width="90%" src="https://files.readme.io/2cbc24abf1b26a232d2fd961461f454ed3a1a1e780227e5e7d6cebe881ba2b4b-wallets-history-03-fund-dialog.png" alt="The Fund Wallet dialog for the Spring credit wallet, with an amount of 5000 and a note entered." />

A refund is blocked if it would take Available below zero. The message reads "Insufficient balance" and shows the most you can refund.

### Edit, deactivate or find wallets

* **Edit.** Open the row menu and select **Edit**. You can change the name, limit, threshold and external ID. You cannot change the currency or the advertiser.
* **Deactivate or reactivate.** Use the switch in the **Active** column. It takes effect straight away and stops all spend from the wallet.
* **Search and filter.** Search by wallet name, or select **Filters** to filter by Wallet Name, External ID, Currency, Wallet ID, Credit Limit or Advertiser. Filters apply across every page.
* **Export.** Select **Export** to download `wallets.csv` for every wallet that matches your search and filters. The **Status** column in the file uses different words from the screen: Active, Capped, RunningLow and Inactive stand for Active, Capped, Low and Deactivated.

### See a wallet's balance history

In the media owner view, balance history and adjustments are shown one wallet at a time. Select the chart icon beside a wallet's row menu to open its **Balance history**.

| Part                    | What it shows                                                                                                                                                                                                                                                                                        |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Available balance**   | The wallet's available balance now                                                                                                                                                                                                                                                                   |
| Date range              | The dates for the chart and the table. The last 30 days by default                                                                                                                                                                                                                                   |
| **Available over time** | How the wallet's available balance changed over those dates                                                                                                                                                                                                                                          |
| **Adjustments**         | Each fund and refund in those dates, with its date, amount and note (the **Memo** column). Funds show as positive amounts and refunds as negative. Search or filter the table, or select **Export** to download `adjustments.csv`. Shown where adjustments are switched on for your business manager |

<Image align="center" border={false} width="90%" src="https://files.readme.io/3d604874a132a4b7c6abf053be6996af64304ee9023608c7037bffda3096b0c5-wallets-history-02-drawer.png" alt="The Balance history drawer for the Spring credit wallet, with its available balance, the date range highlighted, the Available over time chart and an Adjustments table with one fund." />

## Advertiser view

Advertisers see only their own wallets, in read-only form.

### What advertisers see

* **Wallets overview.** Their wallets, with the media owner columns except **Advertiser** and the **Active** switch. They can search, filter and export the list to CSV.
* **Date range.** At the top of the page, the last 30 days by default. It sets the dates for the chart and the table.
* **Available over time.** One line for each wallet on the current page of the list.
* **Adjustments.** Each fund and refund for the wallets on the current page of the list, with the date, wallet name, wallet ID, amount and note. Shown where adjustments are switched on for your business manager. To see adjustments for a wallet further down the list, go to the page of the list that shows it.

<Image align="center" border={false} width="90%" src="https://files.readme.io/ae0a042b15ca9e569e9bb48f28704d2a8127d07939c2ba26223dd9bb3cb0b2ca-wallets-history-05-advertiser-page.png" alt="The Wallets page for an advertiser, with the date range highlighted. The Wallets overview list shows two wallets, with one Available over time chart and one Adjustments table for both below it." />

### Book with a wallet

When an advertiser books on a placement that needs a wallet, the **Campaign details** step has a **Wallet** field. Each option shows the wallet's name and its available balance. The step does not move on until a wallet is chosen. The **Review campaign** step shows the chosen wallet.

| Advertisers can                                                                                                                          | Advertisers cannot                                                       |
| ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| Choose one of their active wallets when they book a campaign                                                                             | Create, edit, fund, refund or deactivate a wallet                        |
| Turn **Campaign spending limit** on or off, and set a campaign budget when it is on                                                      | Change a wallet's limit, notification threshold or currency              |
| Swap the wallet on a live campaign, where the placement lets them. On placements that review wallet changes, the swap waits for approval | Use a deactivated wallet, or a wallet that belongs to another advertiser |
| See their wallets, balances, the Available over time chart and the adjustments, and export the list to CSV                               | See other advertisers' wallets                                           |
| Receive a **Low wallet balance** notification when a wallet reaches its threshold                                                        |                                                                          |

The **Campaign spending limit** switch sits below the **Wallet** field and decides whether the campaign has its own budget. With it off, the campaign draws from the full wallet balance.

<Image align="center" border={false} width="90%" src="https://files.readme.io/12d145b0d052063b088cb44e7573b7776c3d21ed164ff10e507cb658e905ab17-wallets-history-04-booking-field.png" alt="The Campaign details step of a campaign booking. The Wallet field shows the chosen wallet and its available balance, and the Campaign spending limit switch below it is off." />

See [Set up campaign review](https://dev.kevel.com/docs/set-up-campaign-review) for which changes a placement reviews.

## Troubleshooting

**I cannot see Wallets in the sidebar.** The menu item is off for your view of the business manager, or your user has a read-only role. Kevel turns it on separately for media owners and advertisers. Contact your Kevel representative.

**A new wallet reads Capped.** Its limit is 0 and it has not been funded. Fund it, or raise the limit.

### Media owners

**Fund, Refund, Edit, the Active switch or the chart icon is disabled for a wallet.** The wallet's advertiser cannot be matched to an advertiser in your business manager. Contact your Kevel representative with the wallet ID.

**I cannot find an adjustment I made.** Open the balance history of the wallet you funded or refunded, and widen the date range to include the day you made it.

**Saving a wallet fails.** Check that the limit and threshold are whole numbers, and that you have the Admin role. Console shows the error in a message at the top of the screen.

### Advertisers

**An advertiser sees "No wallets found" when booking.** The advertiser has no active wallet. Create one for them, or reactivate a deactivated one.

**The Campaign details step will not continue.** The placement needs a wallet and none is chosen. Select a wallet in the **Wallet** field.

**An advertiser cannot find an adjustment.** The chart and the **Adjustments** table cover only the wallets on the current page of the list. Go to the page of the list that shows the wallet, and widen the date range.

## Related

* [In-app notifications in Console](https://dev.kevel.com/docs/in-app-notifications-in-console)
* [Set up campaign review](https://dev.kevel.com/docs/set-up-campaign-review)
* [Creating Console Campaigns](https://dev.kevel.com/docs/creating-a-campaign)