Wallets

Track points, rewards, or currency balances for your advocates using wallets.

What Are Wallets?

Wallets let you maintain a running balance for each advocate. You define one or more wallet configurations for your community, and every advocate automatically receives a wallet for each configuration.

Each wallet tracks two values:

  • Balance - the current available amount
  • Lifetime - the total amount ever credited to the wallet

Creating Wallet Configurations

Pro plan and above. Cash rewards using standard currency codes (USD, CAD) are available on Pro and Enterprise plans. Custom rewards are available on Enterprise plans only.

  1. Navigate to Settings > Wallet Configurations.
  2. Click Add Wallet Configuration.
  3. Enter a Name for the wallet (e.g., “Referral Points”).
  4. Add a Description to explain the wallet’s purpose.
  5. Select a Currency Code. The default is “PTS” for a generic points system. You can also choose a standard currency code like “USD”.
  6. For a “PTS” wallet, enter a Unit Name, the label shown next to balances (e.g., “points”, “credits”, or “stars”).
  7. Leave Visible to Advocates checked to show advocates their running balance for this wallet. When unchecked, advocates still see the individual rewards they’ve earned in their request history.
  8. Click Create.

Editing a Wallet Configuration

To update an existing wallet configuration:

  1. Navigate to Settings > Wallet Configurations.
  2. Click the wallet configuration you want to edit.
  3. Update the Name, Description, Currency Code, Unit Name, or Visible to Advocates as needed.
  4. Click Update.

Changing the currency of an existing wallet is highly discouraged. It may cause inconsistencies with existing balances.

Viewing Advocate Balances

The wallet configuration edit page also displays an Advocate Balances table showing every advocate’s wallet for that configuration, sorted by highest balance. Each row shows the advocate’s name, current balance, and lifetime balance.

Total Balances on the Index Page

The Wallet Configurations index page displays a Total column showing the aggregate balance across all advocates for each wallet configuration, giving you a quick overview of outstanding balances.

Setting Up Rewards

Rewards that pay into a wallet are set up as activity definitions. On the wallet configuration’s edit page, click Manage Activity Definitions to add rewards that advocates can request, that you can give with one click, or that Stoked claims automatically, like a speedy reply bonus. Click Preview as Advocate to see the Rewards page as advocates see it.

How Wallets Are Created for Advocates

When an advocate is activated, wallets are automatically created for each wallet configuration in your community. If you add a new wallet configuration after advocates are already active, wallets for that configuration are created for existing advocates as well.

Limit to Types

Once your community has more than one advocate type, each wallet configuration has a Limit to types setting. Check the types the wallet is for, and only advocates of those types get it. Leave every box unchecked to give the wallet to every type. When an advocate’s type changes, they get the wallets that apply to their new type. Rewards for a wallet that does not apply to an advocate’s type are not offered to them. Wallets an advocate already has are never removed, and their balances are never changed.

When a wallet no longer applies

If an advocate’s type changes to one a wallet does not apply to, the wallet is kept, with its balance, lifetime total and history, but it is hidden from the advocate and frozen:

  • The advocate no longer sees the wallet, its balance or its history on their site.
  • It can’t be credited, and rewards for it can’t be approved. You will see an error such as “Cafe Wallet is not available to Shop advocates”, and the request stays pending. Rewards that would be approved automatically wait for your review instead.
  • On the advocate’s profile you still see the wallet, marked Not available for the advocate’s type, without reward buttons. You can still debit or reset it to correct the balance.

If the advocate moves back to a type the wallet applies to, it reappears with the same balance and works as before.

Managing an Advocate’s Wallet

To view and manage an advocate’s wallet, navigate to their profile page and select the wallet you want to manage.

Crediting a Wallet

  1. Open the advocate’s wallet page.
  2. Enter the Amount to credit.
  3. Provide a Reason for the credit.
  4. Click Credit Wallet.

Debiting a Wallet

  1. Open the advocate’s wallet page.
  2. Enter the Amount to debit.
  3. Provide a Reason for the debit.
  4. Click Debit Wallet.

A debit cannot exceed the current balance.

Resetting a Wallet

If you need to correct a wallet’s values, you can reset both the balance and lifetime total directly.

  1. Open the advocate’s wallet page.
  2. Enter the new Balance and Lifetime values.
  3. Provide a Reason for the reset.
  4. Click Reset Wallet.

Every credit, debit, and reset is recorded as a transaction. Each transaction includes the amount, the reason provided, and which admin performed the action. You can view the full transaction history on the advocate’s wallet page.

Wallet Activity

On the advocate’s wallet page

The Wallet Details table on an advocate’s wallet page lists every transaction for that wallet, newest first, with its Date, Type, Details, Reason, and who did it (Done By).

What advocates see

Advocates see a card for each wallet on their account page, showing the balance and lifetime total. Clicking View activity opens that wallet’s Activity page, which lists every credit, debit, and reset with its reason, date, and amount. It shows the most recent 100 entries.

Only wallets with Visible to Advocates checked appear, and only if the wallet applies to the advocate’s type.

Exporting Wallets to CSV

From Advocates, click Export CSV and choose:

  • Wallet - one row per advocate with their contact details and, for each wallet, its name, unit name, balance, lifetime total, and currency code. Balances and lifetime totals come twice: labeled (50 points, $100.25) and as plain numbers in the _raw columns, which you can sort and sum in a spreadsheet. The export follows your current search.
  • All Activities - every reward request, with the advocate, the reward, its wallet, amount, status, and who reviewed it.

To export every advocate’s wallets regardless of search, use Operations > Data > Advocates and download the Wallet export. See Advocate Data Import & Export.

Email Notifications

You can configure email notifications to inform advocates when their wallet balance changes. Both are off until you turn them on.

  • Wallet Credited - sends an email whenever the wallet is credited, whether an admin credits it or a reward is approved (including auto-approved rewards)
  • Wallet Debited - sends an email whenever the wallet is debited, including approved Shopify refund reversals

To enable or disable these notifications:

  1. Navigate to Settings > Email Notifications > Advocate.
  2. Click Wallet Credited Template or Wallet Debited Template.
  3. Toggle Notification Enabled on or off.

The same page lets you edit the email’s wording. When a notification is off, the credit or debit form on the advocate’s wallet page reminds you that the advocate won’t be emailed.

If an advocate does not have an email address on file, they will not receive wallet notifications regardless of this setting.


Related: Activity Definitions · Reward Claim Caps · Speedy Reply Bonus


© 2024-2026 Stoked — Real conversations. Real trust.