> 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/referral-program/ultimate-discounts-integration.md).

# Ultimate Discounts integration

Out of the box, the referee side of a referral is a simple percentage or fixed discount. If you run **Dollarlabs: Ultimate Discounts**, you can hand the referee discount over to one of its discounts instead. That brings the app's more advanced discount logic to your referral program while DollarBack keeps handling codes, attribution, and referrer rewards.

## Prerequisites

* A live referral config. See [Set up your referral program](/dollarback-store-credit/referral-program/set-up-your-referral-program.md).
* The **Dollarlabs: Ultimate Discounts** app installed on your store, with at least one discount configured in it that uses the required function type (the integration lists only compatible discounts).

## What changes when the integration is on

|                         | Integration off                                          | Integration on                               |
| ----------------------- | -------------------------------------------------------- | -------------------------------------------- |
| Referee discount        | DollarBack's built-in **Discount Type / Discount Value** | The connected Ultimate Discounts discount    |
| Referral codes          | Pooled on DollarBack's shared discount                   | Pooled on the connected integration discount |
| Referrer reward         | DollarBack store credit                                  | Unchanged; still DollarBack store credit     |
| Attribution & analytics | DollarBack                                               | Unchanged                                    |

## Step 1. Enable the integration

1. Go to **DollarBack admin → Referral** and find the **Dollarlabs: Ultimate Discounts** integration section.
2. If the app isn't installed yet, you'll see an **Install App** button; the integration requires the app to be present (status shows **Installed** once it is).
3. Turn on **Enable Integration** ("Enable integration to offer advanced referee discounts").

## Step 2. Connect the discount

1. With the integration enabled, a **Select Referee Discount** selector appears (showing "— Select a discount —" until you choose).
2. Pick the Ultimate Discounts discount that should apply to referred orders. The summary confirms your choice: "Using \[discount title] from Dollarlabs discount app".
3. If the list is empty you'll see: "No discounts found, make sure discounts with the required function are configured." Create a compatible discount in Ultimate Discounts first, then reopen the selector.
4. Save. Referral codes need to attach to the connected discount, so a bulk sync may run and lock the editor until it completes. See [Referral codes & bulk sync](/dollarback-store-credit/referral-program/referral-codes-and-bulk-sync.md).

## Step 3. Verify at checkout

1. Grab a customer's referral code from the storefront (widget or account page).
2. In an incognito window, build a qualifying cart as a new customer and apply the code at checkout.
3. The discount that applies should be the connected Ultimate Discounts discount. Check that the discount line matches its rules rather than the old built-in value.
4. Complete the order and confirm the referrer's reward still lands in **Analytics → Referral**: the referrer side is untouched by the integration.

{% hint style="warning" %}
Don't delete the connected discount inside Ultimate Discounts while the integration is live; the referral codes are attached to it. Disconnect or switch the discount in DollarBack first.
{% endhint %}

## Common issues

* The selector shows no discounts → the discounts in Ultimate Discounts don't use the required function; recreate the discount with a compatible type.
* Codes apply the old built-in discount → the sync to the integration discount may still be running, or the save didn't complete; check for the bulk-operation banner.
* Referral code rejected at checkout → the connected discount's own rules also apply now, on top of your referral conditions; test the discount by itself in Ultimate Discounts, then see [A referral wasn't tracked](/dollarback-store-credit/troubleshooting-and-faq/referral-wasnt-tracked.md).

## Related articles

* [Set up your referral program](/dollarback-store-credit/referral-program/set-up-your-referral-program.md)
* [Referrer rewards vs referee discounts](/dollarback-store-credit/referral-program/referrer-rewards-vs-referee-discounts.md)
* [Referral codes & bulk sync](/dollarback-store-credit/referral-program/referral-codes-and-bulk-sync.md)
* [Referral conditions & limits](/dollarback-store-credit/referral-program/referral-conditions-and-limits.md)