Двусторонние стимулы

Откройте группу партнёров, для которой нужна скидка, перейдите на вкладку Скидки и нажмите Создать. У группы может быть только одна скидка; нужны разные условия для разных партнёров — заведите отдельные группы.

В окне Создать скидку выберите тип предложения:

• Скидка — процент или фиксированная сумма с оплаты. Задайте величину и срок действия: разово (только первая оплата), на несколько месяцев или пожизненно.
• Бонус — предложение в единицах вашего продукта, которое начисляет ваша система: например, «100 заявок на баланс». Задайте Количество, Единицу и Описание — описание увидят партнёры и клиенты.

Переключатель Автоматически создавать промокоды включает автоматическую выдачу кодов партнёрам группы — о нём в следующем шаге. В блоке Кому видно, на каких партнёров группы распространится скидка. Подтвердите кнопкой Создать скидку.

Промокод — это код, который партнёр даёт своей аудитории: в подкасте, видео, посте, где ссылку не вставить. Каждый код привязан к одной реферальной ссылке партнёра, и у ссылки может быть только один код. Продажи по коду засчитываются той же ссылке, что и переходы по ней.

Автоматически. Если в окне скидки включён переключатель Автоматически создавать промокоды, RevRoute создаст код для ссылки по умолчанию каждого активного партнёра группы, а новым партнёрам — при одобрении заявки. Код собирается из первого слова имени партнёра заглавными буквами и величины скидки: IVAN20OFF для 20%, IVAN5000OFF для 5 000 ₽. Если такой код в программе уже занят, к нему добавляется короткий суффикс.

Вручную. Откройте карточку партнёра, вкладку Ссылки, и нажмите Создать код в блоке Промокоды. Если кнопка неактивна, наведите на неё курсор — подсказка объяснит причину: у группы партнёра нет скидки или у всех его ссылок уже есть промокоды. Во втором случае сначала создайте партнёру новую ссылку.

Кнопка Создать код открывает окно New discount code (его интерфейс пока на английском). Выберите в списке Referral link ссылку, к которой привязать код, введите код в поле Discount code — в подсказке поля показано имя партнёра заглавными буквами, оставьте поле пустым, чтобы код собрался автоматически, — и нажмите Create discount code. Код сохраняется заглавными буквами и сразу копируется в буфер обмена.

Созданный код появится в блоке Промокоды рядом со ссылкой, к которой он привязан. Партнёр увидит его в своём кабинете на карточке этой ссылки с пометкой Промокод — нажатие копирует код. Условия скидки партнёр видит в описании вознаграждений программы: «Новые пользователи получают скидку 10% на 6 мес.».

Клиент может прийти к вам двумя путями, и для каждого RevRoute отдаёт партнёра и условия его скидки.

Клиент перешёл по ссылке партнёра. Если на сайте установлен скрипт RevRoute, партнёр и скидка уже лежат в window.RevRouteAnalytics и в cookie rr_partner_data — подробности в разделе «Баннер скидки на сайте» ниже. На сервере те же данные можно получить по значению cookie rr_id: GET /discount-codes/resolve?clickId=<rr_id>.

Клиент ввёл промокод при оплате. Спросите у RevRoute, чей это код. С сервера — эндпоинт GET /discount-codes/resolve с ключом API вашего рабочего пространства:

curl "https://api.revroute.ru/discount-codes/resolve?code=IVAN20OFF" \
  -H "Authorization: Bearer rr_xxxxxx"

Ответ (служебные поля опущены):

{
  "partner": {
    "id": "pn_xxx",
    "name": "Иван Петров",
    "email": "ivan@example.com",
    "image": null
  },
  "discount": {
    "id": "disc_xxx",
    "offerType": "discount",
    "type": "percentage",
    "amount": 20,
    "maxDuration": 6,
    "bonusQuantity": null,
    "bonusUnit": null,
    "description": null
  },
  "program": { "id": "prog_xxx", "name": "Acme", "slug": "acme" },
  "link": {
    "id": "link_xxx",
    "domain": "refer.example.com",
    "key": "ivan",
    "shortLink": "https://refer.example.com/ivan"
  },
  "discountCode": { "id": "dcode_xxx", "code": "IVAN20OFF" }
}

Как читать условия:

• offerType — discount (скидка) или bonus (бонус в единицах: bonusQuantity, bonusUnit, description).
• type — percentage (процент) или flat (фиксированная сумма). Для flat amount указан в копейках: 500000 — это 5 000 ₽.
• maxDuration — срок в месяцах: 0 — только первая оплата, null — бессрочно.
• discount: null — у кода нет скидки (её удалили), применять нечего.

Неизвестный код — ответ 404: такой промокод в программе не заведён, скидку давать не нужно.

Прямо со страницы оплаты, без ключа API, код можно проверить эндпоинтом POST /track/discount-code — он отдаёт партнёра и условия, но без почты партнёра и внутренних данных программы:

const res = await fetch("https://api.revroute.ru/track/discount-code", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ domain: "refer.example.com", code: enteredCode }),
});
 
if (res.ok) {
  const { partner, discount } = await res.json();
  // показываем клиенту «Промокод от Ивана: скидка 20% на 6 месяцев»
}

domain — домен реферальных ссылок вашей программы. Вызывать этот эндпоинт могут только сайты из списка Разрешённые хосты в Настройки → Аналитика; пока список пуст, он отвечает 403 — это защита от перебора чужих кодов. Лимит — 20 запросов в минуту с одного IP-адреса.

Дальше скидку применяете вы: уменьшаете сумму счёта, добавляете купон в ЮKassa, начисляете бонусные единицы — как устроено в вашей системе.

Применённая скидка ещё не значит, что партнёр получил комиссию: RevRoute узнаёт о продаже только из вашего запроса. После оплаты отправьте её в POST /track/sale и, если клиент пришёл без перехода по ссылке, передайте промокод в поле discountCode:

curl -X POST "https://api.revroute.ru/track/sale" \
  -H "Authorization: Bearer rr_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "customerExternalId": "user_123",
    "amount": 199000,
    "currency": "rub",
    "paymentProcessor": "custom",
    "eventName": "Invoice paid",
    "invoiceId": "INV-1001",
    "discountCode": "IVAN20OFF"
  }'

Как RevRoute решает, кому засчитать продажу:

• Если передан clickId (значение cookie rr_id), продажа идёт партнёру, чью ссылку кликнули, — discountCode игнорируется.
• Если клиент с таким customerExternalId уже известен (например, вы отправили его регистрацию в /track/lead), продажа засчитывается ему как обычно.
• Иначе продажа засчитывается партнёру, которому принадлежит discountCode. Неизвестный код — ответ 404, продажа не записывается.

Поле discountCode так же принимает POST /track/lead — на случай, когда клиент регистрируется с промокодом ещё до оплаты. В amount передавайте сумму, которую клиент реально заплатил, — комиссия партнёра считается от неё.