Skip to content
Toposort Logo
Knowledge Base

Vendor Wallets

Vendor Wallets

Wallets give admin and vendors a better control over their advertising budgets, enabling funds to be divided into different wallets. Each campaign can only spend from its assigned wallet, but multiple campaigns can be linked to the same wallet. This prevents overspending or unintentional use of funds. Marketplace admins can configure and manage wallets for each vendor, and both can create campaigns using the available wallets.

Key Benefits

  • Granular Budget Control: Wallets allow admins to create separate balances per vendor, ensuring funds are allocated appropriately for different product lines, campaigns or cost centers.
  • Improved Financial Transparency: By providing detailed tracking of balances and transactions per wallet, admins and vendors can better monitor ad spend and optimize budget distribution.
  • Enhanced Flexibility: With the ability to top-up and transfer balances between wallets, admins can adapt budgets based on campaign needs while maintaining strict control over fund usage.

How It Works

Wallets can be found on the main dashboard and within each vendor’s view, in the marketplace dashboard. The wallets dialogue allows marketplace admins to create, top-up and transfer balances as needed.

Wallet Creation & Management

  • Admins can create a wallet for a vendor

Top-Up & Fund Transfers

  • Admins can add credit to each wallet independently.
  • Admins can also transfer funds between wallets.

Assigning Wallets to Campaigns

  • During campaign creation, vendors and admins can select a specific wallet to fund that campaign. The wallet option appears only when the advertiser has more than one wallet.
  • Once a wallet is assigned to a campaign, it can’t be changed to preserve budget integrity.

Frequently Asked Questions (FAQ)

  1. Can I delete a wallet?

No. Wallets cannot be deleted in order to maintain a durable record of all financial transactions. To delete your wallet, you must contact your Topsort admin.

  1. What happens when a wallet is assigned to a vendor?

When a wallet is assigned to a vendor, both admins and vendors have the ability to create campaigns using the assigned wallet. Vendors can view their wallet balances in their dashboard but cannot transfer funds between wallets.

  1. Can a campaign be funded by multiple wallets?

No. Each campaign must be linked to a single wallet.

  1. What if a wallet’s balance is too low to continue a campaign?

If a wallet’s balance is insufficient to fund an ongoing campaign, you must top up or transfer the required funds into that wallet, preventing overspending.

  1. Can I use a wallet if my marketplace has self-service payments (via Stripe)?

No. Wallets are not available for marketplaces that use self-service payments.

  1. What happens if a wallet runs out of balance in the middle of a campaign?

If a wallet’s balance is depleted mid-campaign, all campaigns funded by that wallet will automatically pause.

  1. Are wallets available for all versions of Topsort’s public API?

No. Wallets are only available to marketplaces that use version 2 of Topsort’s public API, which are sending events with the resolvedBidID of the auction.

  1. Where can I find more information about the public API for wallets?

You can find detailed documentation about the Topsort public API, including wallet functionality, athttps://api.docs.topsort.com/api-reference/introduction.