For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

  • 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.

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.

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.

Last updated