> 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/spending-store-credit-and-rewards/set-up-the-reward-marketplace.md).

# Set up the reward marketplace

{% embed url="<https://dollarlabs.neetorecord.com/watch/c41f7ce6129e509a8104>" %}

*This article's section starts at 0:00 in the video.*

The reward marketplace lets customers trade store credit for discounts. When you're done here, your storefront widgets, account pages, and (on Shopify Plus) checkout will show a set of rewards customers can claim with their balance.

Rewards do double duty: the same definitions can also be handed out by your cashback programs as earned discount codes. You build a reward once, then decide where it's available.

## Prerequisites

* At least one way for customers to earn credit; see [Set up purchase cashback](/dollarback-store-credit/earning-cashback-programs/set-up-purchase-cashback.md).
* Marketplace surfaces active in your theme and account editor; see [Activate widgets in your theme](/dollarback-store-credit/getting-started/activate-widgets-in-your-theme.md).

## The page at a glance

Open **DollarBack admin → Redemption**. The **Reward marketplace** page lists your rewards as cards; click a reward to expand its editor in place. Below the list sits the **Combinations** card (stacking rules; see [Discount combination rules](/dollarback-store-credit/spending-store-credit-and-rewards/discount-combination-rules.md)), and the right column holds a live **Customer preview** plus the **Rejection messages** panel (covered in [Cart groups, redemption rules & rejection messages](/dollarback-store-credit/spending-store-credit-and-rewards/cart-groups-and-redemption-rules.md)).

Each reward row shows its title, a plain-language summary of what it grants and costs, a status badge, an enable toggle, and edit/delete actions.

## Create a reward

Click **Add reward** and fill in the shared fields:

| Field                          | What it does                                                                                                                                                                                             |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Title**                      | Required. Shown to customers, and used to pick this reward from cashback triggers. Make it self-explanatory ("$5 off your order").                                                                       |
| **Credit cost**                | How much credit the customer pays to claim this reward in the marketplace. For a $5-off reward, a cost of $5 of credit is a 1:1 trade; set it lower to make redemption a perk.                           |
| **Expires after (days)**       | Optional. The expiry date is baked into each minted code, counted from the moment it's issued. Blank means codes don't expire.                                                                           |
| **Max redemptions / customer** | Optional. Caps how many times a customer can redeem this reward by spending credit in the marketplace. New rewards start at 1. Codes issued by cashback programs are limited separately, on the program. |

## Choose the discount classes

This is the big idea of the marketplace: one reward can grant **several kinds of discount at once**. Under **Discount classes**, toggle any combination of three tiles:

| Class        | Grants                                         |
| ------------ | ---------------------------------------------- |
| **Product**  | A discount on specific products or collections |
| **Order**    | A discount on the whole order subtotal         |
| **Shipping** | A discount on shipping cost                    |

Each enabled class gets its own config card, and a single redeemed code carries all of them. "20% off the Treat & Restore collection plus free shipping" is one reward, one code.

### Product discount card

* **Discount type**: **Percentage**, **Fixed amount**, or **Specific price** (sets each targeted item to a fixed unit price).
* **Max items discounted**: cheapest eligible items are discounted first; leave blank for unlimited.
* **Maximum total discount**: a cap across all discounted items; leave blank for no cap.
* **Cart groups**, **Redemption rules**, and **Discount applies to** control which items get the discount and when the code can be used; see [Cart groups, redemption rules & rejection messages](/dollarback-store-credit/spending-store-credit-and-rewards/cart-groups-and-redemption-rules.md).

### Order discount card

* **Discount type**: **Percentage** or **Fixed amount**.
* **Maximum discount** (percentage only): the most the discount can take off; leave blank for no cap.

### Shipping discount card

* **Discount type**: **Percentage** or **Fixed amount**. 100% = free shipping (the default for a new shipping card).
* **Maximum discount** (percentage only): the most you'll take off the shipping rate.
* **Applies to**: **All shipping methods** or **Specific shipping methods**, chosen from your store's shipping rates.

Every class card also carries its own cart groups and redemption rules, so eligibility is configured per class.

## Choose where the reward is available

The **Available in** checkboxes decide which side of DollarBack can hand this reward out:

* **Reward marketplace**: customers can spend store credit to redeem it.
* **Cashback triggers**: cashback configs can issue it as an earned reward; see [Reward discount codes instead of store credit](/dollarback-store-credit/earning-cashback-programs/reward-discount-codes-instead-of-store-credit.md).

Both are on by default. A reward set to Cashback only disappears from the marketplace but stays selectable in your programs; the row's subtitle shows "Marketplace only" or "Cashback only" so you can tell at a glance.

## Status and ordering

* The toggle on each row switches between **Active** and **Draft**. Draft rewards are hidden from customers but keep their configuration.
* Drag rewards to set their order. When several product-discount rewards could apply to the same cart, the one nearest the top wins.

Saving happens through the save bar; a reward needs a title and at least one discount in an enabled class before it will save. The **Customer preview** panel on the right shows exactly what the shopper will read for the reward you're editing, including its "Redeem terms" once you add rules.

## How redemption works behind the scenes

Understanding the mechanics saves support tickets later:

* **The code is minted first, then credit is debited.** When a customer claims a reward, DollarBack creates a unique discount code and charges the credit cost immediately: at claim time, not when the code is used at checkout.
* **Unused value is lost.** If the code's value exceeds the customer's cart total, standard Shopify behavior applies: the remainder isn't banked for later.
* **There is no automatic rollback.** If a code is never used, or the order it was used on is cancelled, the credit is not refunded automatically. Returning that credit is a manual action. Reach out to support if you need to correct a customer's balance.

{% hint style="warning" %}
Every reward code (marketplace redemptions and earned discount-code rewards alike) hangs off one shared Shopify discount whose code is `RDM-(DO NOT DELETE)`. Never delete this discount in your Shopify admin. If it's deleted, every code your customers hold stops working at once.
{% endhint %}

## Verify it works

1. Sign in to your storefront as a test customer with enough credit for your cheapest reward.
2. Open the reward marketplace (account pages or the floating widget's rewards view) and claim a reward.
3. Confirm the balance drops by the credit cost, then apply the code at checkout and confirm the discount applies.
4. In **DollarBack admin → Analytics → Activity**, check the **Discount codes** view shows the Redeemed row.

## Common issues

* A claimed code doesn't work at checkout: the customer sees one of your [rejection messages](/dollarback-store-credit/spending-store-credit-and-rewards/cart-groups-and-redemption-rules.md) explaining why; also see [A reward discount code isn't working](/dollarback-store-credit/troubleshooting-and-faq/reward-discount-code-isnt-working.md).
* A code won't apply alongside another discount: check the **Combinations** card; see [Discount combination rules](/dollarback-store-credit/spending-store-credit-and-rewards/discount-combination-rules.md).
* Customers can't see the marketplace: check the reward is **Active** and available in the **Reward marketplace**, then see [A widget isn't showing on my store](/dollarback-store-credit/troubleshooting-and-faq/widget-isnt-showing.md).

## Related articles

* [Cart groups, redemption rules & rejection messages](/dollarback-store-credit/spending-store-credit-and-rewards/cart-groups-and-redemption-rules.md)
* [Discount combination rules](/dollarback-store-credit/spending-store-credit-and-rewards/discount-combination-rules.md)
* [How customers spend their credit](/dollarback-store-credit/spending-store-credit-and-rewards/how-customers-spend-their-credit.md)
* [Reward discount codes instead of store credit](/dollarback-store-credit/earning-cashback-programs/reward-discount-codes-instead-of-store-credit.md)