> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarback-store-credit/getting-started/how-dollarback-works.md).

# How DollarBack works

DollarBack rewards your customers with store credit for shopping, signing up, referring friends, and more. Customers spend that credit directly at checkout. This page explains the credit lifecycle and the terms you'll see everywhere else in these docs.

## The credit lifecycle: earn → hold → spend → expire

Every dollar of store credit moves through the same four stages.

### 1. Earn

Customers earn credit through **cashback configs**, the rules you create from **DollarBack admin → Home → Cashback tab → Manage configurations**. A config can reward purchases (say, 5% back on everything), account signups, newsletter subscriptions, birthdays, social follows, or custom events you trigger through the API. Referrals are a separate engine with its own rewards. If you turn on loyalty tiers, they decide which purchase programs each customer earns from, and each tier can multiply that cashback (see the **Tier** entry below).

The amount is calculated per order from the order's real paid value: discounts reduce the cashback base, and portions paid with existing store credit or gift cards are handled according to your global settings.

### 2. Hold

Credit is issued when the order hits the trigger you choose: created, paid, or fulfilled. If you set a **holding period**, the credit is held for that many days (0–90) before it becomes spendable. The hold applies to discount-code rewards from orders too. During the hold the credit isn't in the customer's balance and the storefront widgets don't show it; you can see it in **Analytics → Activity**, under **Scheduled**. Holding is your refund buffer: if the order is refunded before the hold ends, the pending credit is clawed back before it ever reaches the customer's balance.

### 3. Spend

Once released, credit lands on the customer's Shopify-native store credit balance. Customers spend it two ways:

* **Directly at checkout**: store credit appears as a payment option, and the customer applies as much of their balance as they like.
* **In the reward marketplace**: customers exchange credit for rewards you define, whether that's an order discount, a product discount, or free shipping. Redeeming a reward mints a unique discount code and debits the credit cost immediately.

### 4. Expire

If you set an expiry, unspent credit expires after that many days, or on the date you picked. Reminder emails go out at the thresholds you configure (for example 14 days and 3 days before expiry), so customers get a nudge to come back and spend. Expired credit is removed from the balance automatically.

## What customers see

On a store with a 5% purchase reward on one collection and no holding period, a purchase looks like this to your customers.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-2f0979e79640da3b7e21882a98d7892e12879fd9%2Fdb-cx-product-page-message.png?alt=media" alt="A product page for Morning Dew Gel Cleanser at $24.00 with the message You will get $1.20 cashback due to Cleanse &#x26; Prep to select items, and an info icon, above the quantity selector and the Add to cart button." width="470"><figcaption><p>On the product page, your customers see what the product earns before they buy.</p></figcaption></figure>

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-d2df4a9de3811a5251f2e77f9453c0134b2d2afe%2Fdb-cx-checkout-apply-store-credit.png?alt=media" alt="The checkout payment section with the Apply store credit option ticked and $20.00 beside it." width="520"><figcaption><p>At checkout, a customer with a balance ticks Apply store credit, Shopify's own store credit option, to spend it.</p></figcaption></figure>

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-f46e33f547e2836e65ffbd6573643c782f4237b2%2Fdb-cx-thank-you-cashback.png?alt=media" alt="The thank-you page order summary with the message Congratulations! You earned $2.33, You earned $2.33 credit for your next order, above four items and totals that show free shipping with an RDM code, Store credit −$20.00 and Total paid $267.00." width="430"><figcaption><p>After the order, the thank-you page confirms the credit it earned for the next order.</p></figcaption></figure>

## Store credit vs discount codes

DollarBack can pay rewards in two different currencies, and it matters which one you pick:

|                  | Store credit                                                    | Discount code                                      |
| ---------------- | --------------------------------------------------------------- | -------------------------------------------------- |
| What it is       | Shopify-native store credit on the customer's account           | A unique, single-use Shopify discount code         |
| Where it's spent | At checkout, as a payment option, combinable with any promotion | In the discount code field at checkout             |
| Partial use      | Yes, unused balance stays on the account                        | No, value beyond the cart total is lost            |
| Expiry           | Follows your credit expiry settings                             | Set on the config that issued the code             |
| Stacking         | Not a discount, so no combination rules apply                   | Follows your store-wide discount combination rules |

Any cashback config can pay out a discount code instead of credit, and every marketplace reward is delivered as a code. All reward codes hang off one shared Shopify discount whose parent code is `RDM-(DO NOT DELETE)`. Never delete it in your Shopify admin, or every outstanding code stops working. See [DollarBack items in your Shopify admin](#dollarback-items-in-your-shopify-admin).

## DollarBack items in your Shopify admin

DollarBack creates a few items in your Shopify admin to run your programs. They look like ordinary discounts, settings or data, but the app depends on them.

{% hint style="danger" %}
**Don't delete, rename or edit these items.** Change your programs from the DollarBack admin instead. DollarBack doesn't re-create the three discounts on its own.
{% endhint %}

| Item                                          | Where you see it                                                                               | What it does                                                                                                                                                                                                                                         | If it's deleted                                                                                                                                                                                                                                                                                                                           |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `RDM-(DO NOT DELETE)`                         | **Discounts**                                                                                  | The shared discount that holds every reward code: reward marketplace redemptions and discount-code rewards from your cashback programs. Each customer's code is an extra code on this one discount.                                                  | Every reward code your customers hold stops working at once, and new codes can't be issued. DollarBack doesn't re-create it on its own; contact us. See [A reward discount code isn't working](/dollarback-store-credit/troubleshooting-and-faq/reward-discount-code-isnt-working.md).                                                    |
| **Redemption code validator (DO NOT DELETE)** | **Discounts** (an automatic discount)                                                          | Checks each reward code at checkout and turns away codes that have expired or don't meet the reward's conditions, with a message that says why.                                                                                                      | Customers no longer see a message that explains why a reward code didn't apply. DollarBack doesn't re-create it on its own.                                                                                                                                                                                                               |
| `DBR-(DO NOT DELETE)`                         | **Discounts**                                                                                  | The shared referral discount. Every customer's referral code is an extra code on it, and it gives the referee their discount.                                                                                                                        | Every customer's referral code stops working. The Referral page then shows every referral config as **Disabled**. Saving the page again creates a new discount, but your customers' existing codes aren't on it; contact us. See [Referral codes & bulk sync](/dollarback-store-credit/referral-program/referral-codes-and-bulk-sync.md). |
| **Hide store credit**                         | **Settings → Payments**, under payment customizations                                          | Applies your [store credit visibility condition](/dollarback-store-credit/spending-store-credit-and-rewards/hide-store-credit-at-checkout.md) at checkout.                                                                                           | Store credit shows at checkout whatever your condition says. DollarBack creates it again the next time you save **DollarBack admin → Settings**.                                                                                                                                                                                          |
| DollarBack's metafields and metaobjects       | Customer and order pages, **Settings → Metafields and metaobjects**, **Content → Metaobjects** | Your program settings (for example the **Global Settings** metaobject) and each customer's referral code, tier and owed balance. See [Metafields & data storage reference](/dollarback-store-credit/developer-tools/metafields-and-data-storage.md). | Editing or deleting them changes your settings or a customer's data without the app knowing, which can break programs or tiers.                                                                                                                                                                                                           |

The three discounts and **Hide store credit** run on DollarBack's own Shopify Functions, so Shopify lists them as app items. Their values come from the DollarBack admin, not from the Shopify pages.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-f2f2a1daf99744a5c8ec7d782a762c899ad90000%2Fdb-p2-ga-discounts-do-not-delete-annotated.png?alt=media" alt="The Shopify admin Discounts list with three active DollarBack discounts, DBR-(DO NOT DELETE) with 8 codes, Redemption code validator (DO NOT DELETE) as an automatic discount, and RDM-(DO NOT DELETE) with 4 codes, above an ordinary store discount."><figcaption><p>In Shopify admin, Discounts lists the three DollarBack discounts. Leave all three in place.</p></figcaption></figure>

{% hint style="warning" %}
If a reward code, referral code or store credit rule suddenly stops working for everyone, first check that these items still exist in your Shopify admin.
{% endhint %}

## Glossary

| Term                   | Meaning                                                                                                                                                                                                                                                          |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Store credit**       | Shopify-native credit on a customer's account, spendable at checkout as a payment option. DollarBack issues, debits, and expires it.                                                                                                                             |
| **Cashback config**    | A rule, opened from the **Cashback** tab on **DollarBack admin → Home**, that defines how customers earn: the type (purchase, signup, newsletter, birthday, social, custom), the value, targeting, dates, and limits.                                            |
| **Reward marketplace** | The catalog of rewards customers can buy with credit: order discounts, product discounts, and free shipping. Managed on the **Reward marketplace** page: **DollarBack admin → Home → Voucher Marketplace tab → Manage rewards**.                                 |
| **Referrer / referee** | In a referral, the *referrer* is the existing customer who shares their code and earns a reward; the *referee* is the new customer who uses the code and gets a discount on their order.                                                                         |
| **Tier**               | A loyalty level (Pro plan and above) with entry conditions, linked purchase programs, and a cashback multiplier. While tiers are active, a customer earns purchase cashback only from the programs linked to their tier, and a customer with no tier earns none. |
| **Holding period**     | The number of days (0–90) issued credit is held before it becomes spendable. Customers don't see held credit. Acts as a refund buffer.                                                                                                                           |
| **Expiry**             | The window after which unspent credit is removed. Reminder emails fire at your configured thresholds beforehand.                                                                                                                                                 |

## Related articles

* [Quick start: launch your first cashback program](/dollarback-store-credit/getting-started/quick-start-launch-your-first-cashback-program.md)
* [How cashback is calculated](/dollarback-store-credit/earning-cashback-programs/how-cashback-is-calculated.md)
* [How customers spend their credit](/dollarback-store-credit/spending-store-credit-and-rewards/how-customers-spend-their-credit.md)
* [Credit expiry and reminders](/dollarback-store-credit/spending-store-credit-and-rewards/credit-expiry-and-reminders.md)
