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: falsei stosuje się przy następnej płatności polecającego, potem consumedPaymentId zapisuje którypay_...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.redeemedpo realizacji kodu (grantKey + redemptionId);referral.convertedprzy 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).