Эта функция доступна только на тарифных планах Business и выше .

Для двусторонних стимулов вам нужна биллинговая система на вашей стороне, которая поддерживает купоны или промокоды. Revroute хранит идентификатор купона, созданного/зарегистрированного в вашей биллинговой системе, и передаёт его в ваш процесс оформления заказа — ваше приложение отвечает за применение этого купона при оплате.

Скидки на основе ссылок обеспечивают лучшую точность атрибуции, так как вы получаете информацию о геолокации клиента, устройстве, данных реферера и UTM-параметрах.

Компромисс заключается в том, что для настройки требуется некоторая работа разработчиков.

Сначала перейдите к группе партнеров, для которой вы хотите создать скидку. На вкладке Discount вы сможете создать скидку для группы

Если у вас уже настроена скидка для группы по умолчанию, вы можете просто продублировать её. Если нет, нажмите Create, чтобы создать первую скидку группы:

Новый купон

Если в вашей биллинговой системе ещё нет купона, вы можете использовать опцию New coupon, чтобы создать новый купон на основе типа скидки (процент или фиксированная сумма), суммы и длительности, установленных в Revroute.

Использовать ID существующего купона

Если у вас уже есть купон в биллинговой системе, вы можете ввести его ID (обычно 8-символьный буквенно-цифровой код) в поле Use existing coupon ID.

Ключ к реализации скидок на основе ссылок — проверка права клиента на скидку через Customers API от Revroute, а затем автоматическое применение соответствующего купона к сессии оформления заказа.

Вот как работает процесс:

1. Когда пользователь нажимает на реферальную ссылку партнера, Revroute отслеживает его как потенциального клиента
2. Во время оформления заказа вы запрашиваете Customers API от Revroute, используя ID пользователя
3. Если клиент имеет право на скидку, вы применяете купон к сессии оформления заказа в вашей биллинговой системе
4. Если нет, вы разрешаете ручной ввод промокодов

Пример ниже иллюстрирует логику с обобщённым клиентом биллинговой системы. Замените billing.checkout.create(...) на эквивалентный вызов в вашей биллинговой системе.

import { dub } from "@/lib/dub.ts";
import { billing } from "@/lib/billing.ts"; // клиент вашей биллинговой системы
 
// 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 }),
  },
});

После настройки подходящие клиенты автоматически увидят применённый промокод при оформлении заказа.

Скидки на основе промокодов гораздо проще настроить (код не требуется).

Однако вы жертвуете точностью атрибуции, так как у вас не будет данных о геолокации клиента, устройстве, реферере и UTM-параметрах. Revroute попытается определить местоположение клиента на основе его платёжного адреса в вашей биллинговой системе, но это может быть неточным.

Сначала перейдите к группе партнеров, для которой вы хотите создать скидку. На вкладке Discount вы сможете создать скидку для группы

Если у вас уже настроена скидка для группы по умолчанию, вы можете просто продублировать её. Если нет, нажмите Create, чтобы создать первую скидку группы:

Новый купон

Если в вашей биллинговой системе ещё нет купона, вы можете использовать опцию New coupon, чтобы создать новый купон на основе типа скидки (процент или фиксированная сумма), суммы и длительности, установленных в Revroute.

Использовать ID существующего купона

Если у вас уже есть купон в биллинговой системе, вы можете ввести его ID (обычно 8-символьный буквенно-цифровой код) в поле Use existing coupon ID.

Автоматическое создание кодов скидок

Когда включено, коды скидок будут автоматически созданы для всех существующих партнеров в этой группе и будущих партнеров при вступлении в эту группу.

Откройте профиль партнера, для которого вы хотите создать код скидки, затем нажмите Create Code в разделе «Discount codes».

Здесь вы можете выбрать, с какой реферальной ссылкой связать код. Затем вы можете создать код скидки.

После создания кода его значение появится в разделе Discount Code, и он будет готов к использованию. В панели партнера они также увидят связанный код скидки в своих партнерских ссылках.