কুপন

গ্রাহকরা checkout-এ প্রয়োগ করতে পারবেন এমন ডিসকাউন্ট কোড তৈরি করুন। শতাংশ বা নির্দিষ্ট পরিমাণ, সময়সীমাবদ্ধ বা সীমাযুক্ত, একবার বা বারবার ব্যবহারযোগ্য।

কুপন ম্যানেজ করা হয় builder-এর Commerce panel > Products > Coupons সাব-ট্যাব থেকে, অথবা SDK-এ proyecta.commerce.coupons ব্যবহার করে।

একটি কুপনের গঠন

ফিল্ড	বিবরণ
code	গ্রাহক checkout-এ যে প্রোমো কোড টাইপ করবেন (যেমন LAUNCH20)
percent_off বা amount_off	একসাথে ব্যবহার করা যাবে না। Percent হলো ১–১০০। Amount হলো সবচেয়ে ছোট কারেন্সি ইউনিটে (cents)।
currency	amount_off ডিসকাউন্টের জন্য প্রয়োজনীয় (তিন অক্ষরের ISO কোড)। তৈরির সময় গ্রহণ করে Stripe-এ পাঠানো হয়, কিন্তু পরে API দ্বারা সংরক্ষিত বা ফেরত দেওয়া হয় না।
duration	once (শুধু প্রথম payment), repeating (duration_in_months-এর জন্য), অথবা forever
duration_in_months	duration যখন repeating তখন প্রয়োজনীয়
max_redemptions	সব গ্রাহক মিলিয়ে মোট সীমা
redeem_by	এই তারিখের পরে কুপন আর কাজ করবে না
name	গ্রাহকদের দেখানো প্রদর্শন নাম
active	মুছে না ফেলে সক্রিয়/নিষ্ক্রিয় করার টগল

কুপন তৈরি করুন

Coupons সাব-ট্যাব থেকে Add coupon ক্লিক করুন এবং ফিল্ডগুলো পূরণ করুন। অথবা SDK-এর মাধ্যমে:

// 20% off forever
await proyecta.commerce.coupons.create({
    code: 'LAUNCH20',
    name: 'Launch discount',
    percent_off: 20,
    duration: 'forever',
});

// $10 off, single use, expires in 30 days
await proyecta.commerce.coupons.create({
    code: 'WELCOME10',
    amount_off: 1000,
    currency: 'USD',
    duration: 'once',
    max_redemptions: 1,
    redeem_by: new Date(Date.now() + 30 * 86400 * 1000).toISOString(),
});

// 50% off for the first 3 months of a subscription
await proyecta.commerce.coupons.create({
    code: 'EARLY3',
    percent_off: 50,
    duration: 'repeating',
    duration_in_months: 3,
});

checkout-এ কুপন প্রয়োগ করুন

Stripe-হোস্টেড checkout পেজে গ্রাহকরা নিজেই কুপন কোড দিতে পারবেন — প্রোমো কোড ফিল্ডটি স্বয়ংক্রিয়ভাবে দেখানো হয়।

await proyecta.commerce.checkout({
    customer_id,
    line_items: [{ variant_id: 'var_pro_monthly' }],
    success_url: 'https://myapp.com/welcome',
});

checkout call-এ প্রোগ্রামাটিক্যালি কুপন কোড পাঠানো এখনও সমর্থিত নয়।

তালিকা দেখুন, আপডেট করুন, নিষ্ক্রিয় করুন

// Browse every coupon (only lists coupons created via the SDK)
const { data } = await proyecta.commerce.coupons.list();
for (const coupon of data.data) {
    console.log(coupon.code, coupon.times_redeemed, '/', coupon.max_redemptions);
}
// Paginate using data.has_more and the starting_after query parameter if needed.

// Disable a coupon (without deleting)
await proyecta.commerce.coupons.update({ couponId: 'coupon_123', active: false });

দ্রষ্টব্য: coupons.list() শুধুমাত্র SDK-এর মাধ্যমে তৈরি কুপনগুলো দেখায়। builder Dashboard-এ তৈরি কুপনগুলো coupons.list() দিয়ে দেখা যাবে না।

নোট ও সীমাবদ্ধতা

• কোড এবং ডিসকাউন্টের পরিমাণ পরিবর্তন করা যায় না। তুমি name আপডেট করতে এবং active টগল করতে পারবে, কিন্তু percent_off, amount_off, বা code পরিবর্তন করা যাবে না। ভিন্ন শর্ত প্রয়োজন হলে নতুন কুপন তৈরি করো।
• times_redeemed স্বয়ংক্রিয়ভাবে বাড়তে থাকে এবং এটি শুধু পড়ার যোগ্য — ক্যাম্পেইনের কার্যকারিতা ট্র্যাক করতে কাজে আসে।
• কুপন প্রতি গ্রাহকের জন্য প্রযোজ্য হয়, প্রতি অর্ডারের জন্য নয় — কোনো কুপন যদি forever হয় এবং একজন গ্রাহক সাবস্ক্রাইব করেন, তাহলে প্রতিটি renewal-এ ডিসকাউন্ট পাবেন।