Kupony i programy poleceń - przegląd

Moduł Promocje (/dashboard/promotions) zarządza dwoma mechanizmami rabatów kodowych, niezależnymi od promocji wbudowanych w ofertę (trial, ogólna zniżka, harmonogram zniżek). Oba mechanizmy wymagają włączenia na konkretnej ofercie w zakładce Oferta → Promocje. Realizacja rabatu następuje po udanej płatności (SUCCESS), a nie tylko w podglądzie ceny.

Dwa produkty w module

  • Kupony (/dashboard/promotions/coupons) - pule kodów (cpn_…) z wygenerowanymi lub wgranymi kodami (code_…). Klient wpisuje kod na checkoutcie /pay lub w sesji checkout.
  • Programy poleceń (/dashboard/promotions/referral) - programy (rfl_…) generujące unikalne linki (rlink_…) z parametrem URL `ref`. Polecony dostaje rabat przy starcie subskrypcji; polecający dostaje nagrodę po konwersji.

Warstwa oferty vs warstwa rozliczeniowa

Na ofercie w promotions.codeRedemption zapisujesz: czy akceptować kupony, listę couponIds, czy akceptować linki polecające, oraz referralId. Bez tego konfiguracja puli/programu istnieje w module Promocje, ale nie działa na danej ofercie.

Po SUCCESS Zevio zapisuje audyt PromotionRedemption oraz wpisy w subscription.subscriptionPromotions.entries. Te wpisy sterują kolejnymi cyklami rozliczeniowymi (once / repeating / forever).

Statusy

  • ACTIVE - można przypinać do ofert i realizować.
  • INACTIVE - wyłączony bez archiwizacji; nie przyjmuje nowych realizacji.
  • ARCHIVED - ukryty z aktywnej listy; kupony można przywrócić (restore), programów poleceń nie da się przywrócić.

Kiedy działa który mechanizm

  • Kupony: oferty jednorazowe i subskrypcyjne (zależnie od typu rabatu i konfiguracji oferty).
  • Polecenia: wyłącznie oferty z włączoną subskrypcją; przełącznik linków polecających jest zablokowany bez rekurencji.
  • Parametr URL kuponu/polecenia: dla poleceń kanoniczny jest `ref` (wielkie litery w kodzie). Obecność ref na /pay ukrywa pole ręcznego kodu kuponu i próbuje auto-aplikować link.

Webhooki i REST

  • promotion.redeemed - grant kuponu lub rabatu poleconego (side: coupon | referral).
  • referral.converted - przyznanie nagrody polecającemu po konwersji.
  • REST (klucz API): GET/POST /promotions/coupons, PUT /promotions/coupons/{qrId}, GET/POST /promotions/referrals, PUT /promotions/referrals/{qrId}, status linku po sub_… / cus_….

Powiązane strony dokumentacji

  • Kupony (pule kodów) - pełna lista pól tworzenia, limity, archiwizacja, kody.
  • Programy poleceń - reguły obu stron, limity, linki, UI portalu, edge case’y.
  • Oferta - promocje - trial, zniżki wbudowane oraz przełączniki code redemption.