Cupoane

Creează coduri de reducere pe care clienții le pot aplica la checkout. Procentuale sau cu sumă fixă, limitate în timp sau cu număr maxim de utilizări, o singură dată sau recurente.

Cupoanele sunt gestionate în aplicația ta la Admin > Commerce > Products, în secțiunea Coupons, și în tab-ul Cupones din panoul de administrare al aplicației publicate.

Structura unui cupon

Câmp	Detalii
code	Codul promoțional pe care clienții îl introduc la checkout (ex. LAUNCH20)
percent_off sau amount_off	Se exclud reciproc. Procentul este între 1–100. Suma este exprimată în cea mai mică unitate monetară (cenți).
currency	Obligatoriu pentru reducerile amount_off (cod ISO din trei litere). Acceptat la creare și transmis către Stripe, dar nu este stocat sau returnat ulterior de API.
duration	once (doar prima plată), repeating (pentru duration_in_months), sau forever
duration_in_months	Obligatoriu când duration este repeating
max_redemptions	Limita totală de utilizări pentru toți clienții
redeem_by	Data de expirare după care cuponul nu mai funcționează
name	Numele afișat clienților
active	Comutator pentru activare/dezactivare fără ștergere

Creează un cupon

Din sub-tab-ul Coupons, apasă Add coupon și completează câmpurile. Câteva configurații comune:

Obiectiv	Setări
20% reducere permanent	percent_off: 20, durată forever
$10 reducere, o singură utilizare, expiră în 30 de zile	amount_off: 1000, monedă USD, durată once, număr maxim de utilizări 1, data expirării peste 30 zile
50% reducere în primele 3 luni ale unui abonament	percent_off: 50, durată repeating, durată în luni 3

Sau pur și simplu cere AI-ului: "Create a LAUNCH20 coupon for 20% off forever."

Aplică un cupon la checkout

Există două moduri prin care un client poate folosi un cod:

• Pe pagina de checkout Stripe — câmpul pentru codul promoțional este afișat automat, astfel că un client poate introduce codul acolo fără nicio intervenție din partea ta.
• În propriul tău coș de cumpărături — adaugă un câmp pentru codul promoțional în coșul tău și transmite ce a introdus clientul în apelul de checkout ca couponCode. Serverul validează codul și calculează reducerea din datele tale de comerț (niciodată dintr-o sumă furnizată de browser), o înregistrează pe comandă și atașează cuponul Stripe corespunzător pentru ca plata să fie corectă.

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

Listare, actualizare, dezactivare

Sub-tab-ul Coupons listează toate cupoanele împreună cu numărul de utilizări față de limita setată, astfel încât să poți urmări performanța campaniei dintr-o privire. Editarea este deliberat limitată — vezi mai jos — dar poți dezactiva orice cupon fără să îl ștergi, ceea ce îl face imediat nefuncțional la checkout.

Note și limitări

• Codurile și sumele de reducere sunt imuabile. Poți actualiza name-ul afișat și comuta active, dar nu percent_off, amount_off sau code în sine. Creează un cupon nou dacă ai nevoie de condiții diferite.
• times_redeemed se incrementează automat și este read-only — util pentru urmărirea performanței campaniei.
• Cupoanele se aplică per client, nu per comandă — dacă un cupon este forever și un client se abonează, fiecare reînnoire beneficiază de reducere.