Kupony i programy poleceń - przegląd

Moduł Promocje w panelu (/dashboard/promotions) uzupełnia promocje wbudowane w ofercie (trial, zniżki) o kody rabatowe i programy poleceń. Kupony to pule kodów, które klient wpisuje przy płatności. Program poleceń generuje unikalne linki dla aktywnych subskrybentów - po udanej płatności poleconego obie strony mogą otrzymać rabat procentowy na kolejne płatności subskrypcji.

Dwie zakładki w panelu

  • Kupony (/dashboard/promotions/coupons) - tworzenie pul, generowanie lub wgrywanie kodów, limity wykorzystań, archiwizacja.
  • Programy poleceń (/dashboard/promotions/referral) - reguły rabatu dla poleconego i polecającego, limity, statystyki linków i konwersji.

Włączenie na ofercie

Po utworzeniu puli kuponów lub programu poleceń włącz je w formularzu oferty w sekcji kodów rabatowych: zaznacz akceptowane pule kuponów i/lub program poleceń. Bez tego krok klient nie zobaczy pola Kod rabatowy ani link polecający nie zadziała na danej ofercie.

Jak kody wpływają na rozliczenie subskrypcji

Kody kuponów i polecające są realizowane po udanej płatności (nie w podglądzie). Zevio przechowuje dwie warstwy: PromotionRedemption (audyt grantu: który kod, która płatność go wywołała) oraz subscription.subscriptionPromotions.entries (stan rozliczeniowy na kolejne faktury). Każdy wpis używa redemptionId jako klucza grantu (redeem_{paymentId} lub referrer_{refereePaymentId}) zgodnego z PromotionRedemption.idempotencyKey - to nie to samo co kolumna redemptionId w rekordzie grantu.

  • Kupon / polecony once - rabat na płatności, przy której użyto kodu; wpis oznaczany jako wykorzystany z consumedPaymentId = ten pay_....
  • Polecający once - nagroda przyznawana po płatności poleconego; wpis startuje z consumed: false i stosuje się przy następnej płatności polecającego, potem consumedPaymentId zapisuje który pay_... go rozliczył.
  • Forever - aktywny do zmiany reguł programu; wiele nagród polecającego sumuje się do limitu programu.
  • Szczegóły subskrypcji pokazują billingSummary.promotionPlanSteps (aktywne/wykorzystane). Rekord płatności przechowuje tylko łączny rabat w typeData, bez rozbicia na kody.
  • Webhooki: promotion.redeemed po realizacji kodu (grantKey + redemptionId); referral.converted przy przyznaniu nagrody polecającego (referrer_{refereePaymentId}). Szczegóły: Webhooki.

Powiązane rozdziały

  • Kupony (pule kodów) - typy rabatu, trwanie, kody, limity.
  • Programy poleceń - linki, nagrody, limity polecającego.
  • Oferta - promocje - promocje wbudowane w ofercie (trial, zniżki) oraz kupony/referral.
  • Oferta - opłaty dodatkowe - katalog pozycji doliczanych do kwoty i zakładka Opłaty w ofercie.

Dwa moduły w menu Promocje

Sekcja Promocje w panelu (obok Ofert) to globalne narzędzia niezależne od pojedynczej oferty: Kupony (pule kodów) i Programy poleceń. Promocje na poziomie oferty (trial, ogólna zniżka, harmonogram) konfigurujesz w formularzu oferty → zakładka Promocje.

Kupony vs promocje oferty

  • Pula kuponów - wiele kodów rabatowych (np. SUMMER2026) przypisanych do puli; klient wpisuje kod na stronie płatności.
  • Promocje oferty - automatyczne (trial, zniżka ogólna) bez wpisywania kodu.
  • Kupony nie działają z subskrypcją, jeśli oferta ma wyłączone kody - sprawdź ustawienia w Oferta - promocje.

Programy poleceń vs linki w ofercie

Program poleceń definiuje korzyści polecającego i poleconego. Na ofercie włączasz Zezwól na linki polecające i wybierasz program. Aktywny subskrybent generuje link w portalu klienta; parametr referral w URL aktywuje rabat przy checkout.

Analityka promocji

Realizacje kuponów widać w szczegółach puli. Konwersje poleceń - w szczegółach programu i w Analityka → Źródła (atrybucja referral).

Dostęp i role

Moduł Promocje jest tylko w kontekście organizacji. MEMBER nie ma dostępu (404 przy bezpośrednim linku). Brak osobnej blokady planowej - ograniczenia wynikają z typu oferty (np. kupon bez subskrypcji).

Kupony i programy poleceń - przegląd | Zevio