Kupony

Twórz kody rabatowe, które klienci mogą stosować przy kasie. Procentowe lub kwotowe, ograniczone czasowo lub ilościowo, jednorazowe lub cykliczne.

Kuponami zarządzasz w sekcji Admin > Commerce > Products swojej aplikacji, w zakładce Coupons, oraz w zakładce Cupones panelu administracyjnego opublikowanej aplikacji.

Budowa kuponu

Pole	Uwagi
code	Kod promocyjny, który klienci wpisują przy kasie (np. LAUNCH20)
percent_off lub amount_off	Wzajemnie wykluczające się. Procent wynosi 1–100. Kwota podawana jest w najmniejszej jednostce waluty (grosze/centy).
currency	Wymagane dla rabatów amount_off (trzyliterowy kod ISO). Przyjmowane podczas tworzenia i przekazywane do Stripe, ale nie przechowywane ani nie zwracane przez API afterwards.
duration	once (tylko pierwsza płatność), repeating (przez duration_in_months) lub forever
duration_in_months	Wymagane, gdy duration ma wartość repeating
max_redemptions	Łączny limit realizacji dla wszystkich klientów
redeem_by	Data wygaśnięcia, po której kupon przestaje działać
name	Nazwa wyświetlana klientom
active	Przełącznik włączający/wyłączający kupon bez jego usuwania

Tworzenie kuponu

W podzakładce Coupons kliknij Add coupon i wypełnij pola. Kilka typowych konfiguracji:

Cel	Ustawienia
20% zniżki na zawsze	percent_off: 20, duration forever
10 USD zniżki, jednorazowe użycie, wygasa za 30 dni	amount_off: 1000, currency USD, duration once, max redemptions 1, redeem-by za 30 dni
50% zniżki przez pierwsze 3 miesiące subskrypcji	percent_off: 50, duration repeating, duration in months 3

Możesz też po prostu zapytać AI: "Create a LAUNCH20 coupon for 20% off forever."

Stosowanie kuponu przy kasie

Klient może skorzystać z kodu na dwa sposoby:

• Na stronie kasy Stripe — pole na kod promocyjny jest wyświetlane automatycznie, dzięki czemu klient może wpisać kod bez żadnych dodatkowych działań z Twojej strony.
• We własnym koszyku — dodaj pole na kod promocyjny do koszyka i przekaż wpisaną wartość do wywołania kasy jako couponCode. Serwer weryfikuje kod i oblicza rabat na podstawie danych commerce (nigdy na podstawie kwoty dostarczonej przez przeglądarkę), rejestruje go w zamówieniu i dołącza odpowiedni kupon Stripe, aby płatność była prawidłowa.

Zapytaj AI: "Add a promo code field to the cart and apply it at checkout."

Przeglądanie, edytowanie, dezaktywowanie

Podzakładka Coupons wyświetla wszystkie kupony wraz z informacją, ile razy zostały zrealizowane w stosunku do limitu, dzięki czemu możesz na bieżąco śledzić wyniki kampanii. Możliwości edycji są celowo ograniczone — szczegóły poniżej — jednak każdy kupon możesz dezaktywować bez usuwania, co natychmiast uniemożliwia jego użycie przy kasie.

Uwagi i ograniczenia

• Kody i kwoty rabatów są niezmienne. Możesz zaktualizować wyświetlaną name oraz przełącznik active, ale nie percent_off, amount_off ani sam code. Jeśli potrzebujesz innych warunków, utwórz nowy kupon.
• times_redeemed jest automatycznie inkrementowane i jest tylko do odczytu — przydatne do śledzenia wyników kampanii.
• Kupony obowiązują w przeliczeniu na klienta, nie na zamówienie — jeśli kupon jest forever i klient wykupuje subskrypcję, każde odnowienie otrzymuje rabat.