कूपन

डिस्काउंट कोड बनाएं जिन्हें ग्राहक checkout पर apply कर सकते हैं। Percentage या fixed-amount, time-limited या capped, one-time या recurring।

कूपन को तुम्हारे app के Admin > Commerce > Products में, Coupons के अंतर्गत, और तुम्हारे published app के admin panel के Cupones tab में manage किया जाता है।

कूपन की संरचना

फ़ील्ड	विवरण
code	वह promo code जो ग्राहक checkout पर टाइप करते हैं (जैसे LAUNCH20)
percent_off या amount_off	ये दोनों एक साथ उपयोग नहीं किए जा सकते। Percent 1–100 के बीच होता है। Amount सबसे छोटी currency unit (cents) में होता है।
currency	amount_off discounts के लिए आवश्यक (तीन अक्षरों का ISO code)। Creation पर accept होता है और Stripe को forward किया जाता है, लेकिन बाद में API द्वारा store या return नहीं किया जाता।
duration	once (केवल पहला payment), repeating (duration_in_months के लिए), या forever
duration_in_months	duration के repeating होने पर आवश्यक
max_redemptions	सभी ग्राहकों में कुल उपयोग की सीमा
redeem_by	वह expiration date जिसके बाद कूपन काम करना बंद कर देता है
name	ग्राहकों को दिखाया जाने वाला display name
active	बिना delete किए enable/disable करने का toggle

कूपन बनाएं

Coupons sub-tab से, Add coupon पर क्लिक करो और फ़ील्ड भरो। कुछ सामान्य उदाहरण:

लक्ष्य	सेटिंग्स
हमेशा के लिए 20% off	percent_off: 20, duration forever
$10 off, single use, 30 दिनों में expire	amount_off: 1000, currency USD, duration once, max redemptions 1, redeem-by 30 दिन बाद
subscription के पहले 3 महीनों में 50% off	percent_off: 50, duration repeating, duration in months 3

या AI से पूछो: "Create a LAUNCH20 coupon for 20% off forever."

Checkout पर कूपन apply करें

ग्राहक कोड दो तरीकों से उपयोग कर सकता है:

• Stripe checkout page पर — promo code का फ़ील्ड अपने आप दिखता है, इसलिए ग्राहक वहां कोड टाइप कर सकता है, तुम्हें कुछ अलग से करने की ज़रूरत नहीं।
• अपने cart में — अपने cart में एक promo-code फ़ील्ड जोड़ो और ग्राहक द्वारा टाइप किया गया कोड checkout call में couponCode के रूप में पास करो। Server कोड को validate करता है और discount को तुम्हारे commerce data से compute करता है (browser द्वारा दी गई किसी amount से नहीं), इसे order पर record करता है, और matching Stripe coupon attach करता है ताकि charge सही हो।

AI से पूछो: "Add a promo code field to the cart and apply it at checkout."

List करें, update करें, deactivate करें

Coupons sub-tab में हर कूपन यह दिखाते हुए list होता है कि उसे उसकी cap के मुकाबले कितनी बार redeem किया गया है, ताकि तुम एक नज़र में campaign performance track कर सको। Editing जानबूझकर सीमित है — नीचे देखो — लेकिन तुम किसी भी कूपन को delete किए बिना inactive कर सकते हो, जो तुरंत उसे checkout पर काम करना बंद कर देता है।

नोट्स और सीमाएं

• Codes और discount amounts अपरिवर्तनीय हैं। तुम display name update कर सकते हो और active toggle कर सकते हो, लेकिन percent_off, amount_off, या code नहीं बदल सकते। अगर अलग terms चाहिए तो नया कूपन बनाओ।
• times_redeemed अपने आप बढ़ता है और read-only है — campaign performance track करने के लिए उपयोगी।
• कूपन प्रति ग्राहक apply होते हैं, प्रति order नहीं — अगर कोई कूपन forever है और कोई ग्राहक subscribe करता है, तो हर renewal पर discount मिलेगा।