Oferta - promocje

Zakładka Promocje w formularzu oferty łączy promocje wbudowane w ofertę z akceptacją kodów zewnętrznych (kupony i programy poleceń). Pola trial i linków polecających wymagają włączonej subskrypcji w zakładce Podstawowe; ogólna zniżka i harmonogram mogą działać także bez rekurencji (z ograniczeniami modelu).

Dostęp próbny (trial)

Przełącznik trialAccessEnabled. Bez subskrypcji kontrolka jest nieaktywna. Po włączeniu konfigurujesz typ okresu i cenę trialu.

Typ okresu próbnego

• Liczba płatności - 1-999 pierwszych cykli; w API duration jako NP (np. 1P).
• Czas - token częstotliwości: presety dzień/tydzień/miesiąc/kwartał/pół roku/rok albo Inna (1-999 + D/W/M/Y).

Cena w okresie próbnym

• Kwota ≥ 0 i ≤ cenie oferty. 0 = darmowy trial.
• Darmowy trial wymaga metody/providera obsługującego 0: karta/Apple/Google - TPAY|PAYU|STRIPE; BLIK - TPAY|STRIPE.
• Przy Stripe i karcie kwota musi być 0 albo ≥ 2 (minimum Stripe).
• Model A (API/legacy): trial max 1 płatność albo czas ≤ jeden okres rozliczeniowy.

Ogólna zniżka

Procent 0-100 na wybrany czas. Typy: liczba płatności / czas (token) / bezterminowo. Opcjonalne API-only paymentCountFrom (0-998) przesuwa okno startu zniżki liczonej w płatnościach. Na /pay klient widzi obniżone Do zapłaty dzisiaj w okresie obowiązywania.

Harmonogram zniżek

Lista przedziałów dat z procentem 0-100. Data końca musi być ≥ startu; przy włączeniu wymagany ≥ 1 wpis. W UI model A blokuje harmonogram; modele M/O (w panelu domyślnie O) go pozwalają. Przedziały mogą pokrywać kampanie kalendarzowe niezależnie od trialu.

Akceptacja kodów kuponów

• Przełącznik allowCouponCodes.
• Gdy włączony - wymagany wybór ≥ 1 puli ACTIVE (couponIds).
• Bez przełącznika pole kodu na checkoutcie nie przyjmie kuponów tej oferty (code_redemption_disabled).

Akceptacja linków polecających

• Przełącznik allowReferralLinks - tylko przy subskrypcji.
• Wymagany wybór jednego programu ACTIVE (referralId).
• Link klienta musi nieść parametr `ref`. Szczegóły reguł: Programy poleceń.

Kolejność stosowania na checkoutcie

• 1. Cena bazowa oferty (netto/VAT/brutto, opłaty dodatkowe).
• 2. Trial / ogólna zniżka / harmonogram z oferty.
• 3. Kod kuponu lub ref - merge podglądu: procent zastępuje generalDiscount oferty; fixed_gross wpływa jak trialAccess.
• 4. Po SUCCESS grant trafia na subskrypcję i steruje kolejnymi cyklami niezależnie od samego podglądu.