This feature is only available on Business plans and above .

To offer dual-sided incentives you need a billing system on your side that supports coupons or promo codes. Revroute stores the coupon identifier generated/registered in your billing system and surfaces it to your checkout flow — your application is responsible for applying that coupon at payment time.

Link-based discounts provide better attribution accuracy since you get visibility into the customer’s geolocation, device info, referrer details, and UTM data.

The trade-off here is that it requires some engineering work to set up.

First, navigate to the partner group that you want to create a discount for. Under the Discount tab, you’ll be able to create a discount for the group

If you already have a discount set up for your default group, you can just duplicate it. If not, click Create to create your first group discount:

New coupon

If you don’t have a coupon set up in your billing system yet, you can use the New coupon option to create one based on the discount type (percentage vs flat), amount, and duration set in Revroute.

Use existing coupon ID

If you already have an existing coupon in your billing system, you can enter its ID (typically an 8-character alphanumeric code) under the Use existing coupon ID option.

The key to implementing link-based discounts is to check if a customer is eligible for a discount using Revroute’s Customers API, then automatically apply the appropriate coupon to their checkout session.

Here’s how the flow works:

1. When a user clicks a partner referral link, Revroute tracks them as a potential customer
2. During checkout, you query the Revroute Customers API using the user’s ID
3. If they’re eligible for a discount, you apply the coupon to their checkout session in your billing system
4. If not, you allow them to enter promotion codes manually

The example below illustrates the logic using a generic billing-system client. Replace billing.checkout.create(...) with the equivalent call in your own billing system.

import { dub } from "@/lib/dub.ts";
import { billing } from "@/lib/billing.ts"; // your billing-system client
 
// Get customer discount eligibility from Revroute
const customers = await dub.customers.list({
  externalId: userId, // their user ID within your app
  includeExpandedFields: true,
});
 
const customerDiscount = customers.length > 0 ? customers[0].discount : null;
 
// Create checkout session with conditional discount
const session = await billing.checkout.create({
  successUrl: "https://app.domain.com/upgraded",
  cancelUrl: "https://app.domain.com/pricing",
  lineItems: [
    {
      priceId: "price_xxx",
      quantity: 1,
    },
  ],
  mode: "subscription", // or "payment" for one-time purchases
  ...(customerDiscount
    ? {
        // Apply discount automatically if customer is eligible
        couponId:
          process.env.NODE_ENV !== "production" &&
          customerDiscount.couponTestId
            ? customerDiscount.couponTestId
            : customerDiscount.couponId,
      }
    : {
        // Allow manual promo code entry if no automatic discount
        allowPromotionCodes: true,
      }),
  customerEmail: userEmail,
  metadata: {
    userId,
    ...(customerDiscount && { dubDiscountId: customerDiscount.id }),
  },
});

Once this is set up, eligible customers will automatically see the coupon code applied at checkout.

Promo-code-based discounts are much easier to set up (no code required).

However, you do sacrifice on attribution accuracy since you won’t have any insights into the customer’s geolocation, device info, referrer details, and UTM data. Revroute will try to derive the customer’s location based on the billing address from your billing system, but it can sometimes be inaccurate.

First, navigate to the partner group that you want to create a discount for. Under the Discount tab, you’ll be able to create a discount for the group

If you already have a discount set up for your default group, you can just duplicate it. If not, click Create to create your first group discount:

New coupon

If you don’t have a coupon set up in your billing system yet, you can use the New coupon option to create one based on the discount type (percentage vs flat), amount, and duration set in Revroute.

Use existing coupon ID

If you already have an existing coupon in your billing system, you can enter its ID (typically an 8-character alphanumeric code) under the Use existing coupon ID option.

Auto-provision discount codes

When enabled, discount codes will be automatically created for all existing partners in this group and future partners when they join this group.

Open the partner profile that you’d like to create a discount code for, then click Create Code in the “Discount codes” section.

Here you can select which referral link you’d like to associate the code with. Then you can create the discount code.

After the code has been created, you’ll see its value populated in the Discount Code section, and it is ready for use. In the Partner Dashboard, they’ll also see the associated discount code within their partner links.