Wallets Overview

Networks and advertisers usually have one or more financial agreements, and wallets are a useful tool to capture the initial agreement and manually track progress toward a committed spend.

Wallets are a shared resource between a network and an advertiser. For every linked organisation, you will have a shared wallet. A valid wallet must be configured between your organisation and your linked organisation before you can create a plan, ad set, or an ad.

All wallets in the Zitcha platform have a required set of basic properties: a name, an initial balance, a start date, and an end date. Wallets will inherit the currency of the network organisation.

A wallet is the earliest stage of retail media planning that can be represented within the Zitcha platform.

Wallet Components

Wallets offer flexibility in their configuration through the following components:

• Name: A human-readable name used to identify the wallet when assigning it to a plan.
• Initial Balance: The starting balance of the wallet. This may represent a total committed value for a Joint Business Plan (JBP).
• Minimum Balance: The lowest value the wallet can reach before it is no longer usable.
• Start Date: The date from which the wallet’s balance is valid.
• End Date: The last date the wallet can be used, regardless of how much remains.
• Additional Info: A description of the wallet’s function.
• Allow Overdraw: A flag to indicate whether the balance of the wallet can go below zero.
• Credit Note: An entry that increases the wallet’s balance.
• Debit Note: An entry that decreases the wallet’s balance, such as allocating funds for an ad set.
• Net Position: The balance after all credit and debit entries are recorded.
• Available Balance: The funds currently available for planning purposes.

Note: For wallets that do not allow overdraw, the Net Position and Available Balance will be the same. For wallets that allow overdraw, the available balance is not limited.

Common Wallet Structures

It is common for a network and an advertiser to share more than one wallet. Two common configurations include:

• Terms of Trade: The retail media commitment agreed upon, often as part of a joint business plan. These commitments are typically annual.
• Over and Above: Additional financial commitments made by the advertiser to the network beyond standard terms.

Viewing Wallets

To view a wallet as a network user:

1. In the Zitcha platform, go to Settings > Supplier, and select your advertiser.
2. Click Wallets.
3. Locate the wallet you’d like to view, click the more icon, and select View Transactions.
4. To download transactions, click Download CSV at the bottom of the page.

To view a wallet as an advertiser:

1. In the Zitcha platform, go to Wallets in the left-hand menu.
2. Locate the wallet, click the more icon, and select View Transactions.
3. Click Download CSV to export the transactions.

Creating Wallets

Wallets are managed by the network only. Users with the Wallet Manager permission can view, create, update, and delete wallets.

Before you begin: Check if a wallet with the same purpose already exists.

To create a new wallet:

1. In the Zitcha platform, go to Settings > Supplier, then select the advertiser.
2. Click Wallets.
3. Click + New.
4. Enter a name, initial balance, start date, and end date.
5. Optionally, enter a minimum balance or select whether to allow overdraw.
6. Click Create.

You can create multiple wallets for a single advertiser. Once created, the linked organisation can view the wallet and its details.

To assign a wallet to a plan, refer to the Creating a Plan documentation.

Updating Wallets

Wallets are managed by the network only. Users with the Wallet Manager permission can update wallet details.

To update a wallet:

1. In the Zitcha platform, go to Settings > Supplier, and select the relevant advertiser.
2. Click Wallets.
3. Find the wallet you want to update, click the more icon, and select View Transactions.
4. To add a credit note, click + Add Credit Note, and provide the amount and a description.
5. To add a debit note, click – Add Debit Note, and provide the amount and a description.

Note: Once added, transaction notes cannot be removed.

Assigning Wallets to Plans

Wallets must be manually assigned to plans to allocate spend. Once assigned, any associated ad sets will be reflected in the wallet via debit notes entered by the Wallet Manager.