পণ্য ও ফিচার

আপনি কী বিক্রি করেন তা নির্ধারণ করুন। এক বা একাধিক ভেরিয়েন্ট সহ পণ্য তৈরি করুন, এনটাইটেলমেন্ট-ভিত্তিক অ্যাক্সেস কন্ট্রোলের জন্য পুনরায় ব্যবহারযোগ্য ফিচার যুক্ত করুন।

Proyecta Commerce তিনটি ধারণা ব্যবহার করে: পণ্য, ভেরিয়েন্ট, এবং ফিচার।

• পণ্য — আপনি যা বিক্রি করেন (যেমন “Pro Plan”, “T-shirt”, “Strategy Call”)
• ভেরিয়েন্ট — একটি পণ্যের মূল্য স্তর বা কনফিগারেশন (যেমন “Pro Monthly $29”, “Pro Annual $290”, “T-shirt – Large”)
• ফিচার — একটি পুনরায় ব্যবহারযোগ্য এনটাইটেলমেন্ট কী যা রানটাইমে তোমার অ্যাপ চেক করে (যেমন pro_features, unlimited_projects, api_access)

একটি পণ্যে একাধিক ভেরিয়েন্ট থাকতে পারে। একটি পণ্যে এক বা একাধিক রিসোর্সও যুক্ত থাকে — সাধারণত ফিচার — যা কোনো গ্রাহক সাবস্ক্রাইব করলে অ্যাক্সেস প্রদান করে।

পণ্য তৈরি করা

Dashboard > Commerce > Products-এ গিয়ে Create product বাটনে ক্লিক করো (অথবা AI-কে জিজ্ঞেস করো: "Create a Pro plan at $29/month and a Business plan at $99/month."). প্রতিটি পণ্যের জন্য প্রয়োজন:

• একটি ডিসপ্লে নাম (যেমন “Pro”)
• কমপক্ষে একটি ভেরিয়েন্ট

ভেরিয়েন্ট

প্রতিটি ভেরিয়েন্টের নিজস্ব মূল্য নির্ধারণ থাকে:

ফিল্ড	বিবরণ
name	ভেরিয়েন্টের ডিসপ্লে লেবেল (“Monthly”, “Annual”, “Large”)
currency	তিন অক্ষরের ISO কোড — USD, EUR, GBP, JPY, BRL, MXN, INR… (SDK ১৩০+ সাপোর্ট করে)
unit_amount	সবচেয়ে ছোট মুদ্রা এককে মূল্য (সেন্ট)। 2900 = $29.00
recurring	ঐচ্ছিক — { interval: 'week' | 'month' | 'year' }। এককালীন মূল্যের জন্য বাদ দাও। দৈনিক বিলিং বর্তমানে সাপোর্টেড নয়।
is_default	গৃহীত কিন্তু এখনও কার্যকর নয় — ডিফল্ট ভেরিয়েন্ট নির্বাচন বর্তমানে বাস্তবায়িত হয়নি।
media	CDN ফাইল ID দিয়ে ছবি বা ভিডিও যুক্ত করো (দেখো Files)

মূল্য অপরিবর্তনীয়। একবার ভেরিয়েন্ট তৈরি হলে তার মূল্য পরিবর্তন করা যাবে না — পরিবর্তে নতুন ভেরিয়েন্ট তৈরি করো। এটি বিদ্যমান সাবস্ক্রাইবারদের অনিচ্ছাকৃত মূল্য পরিবর্তন থেকে সুরক্ষিত রাখে।

ফিচার (এনটাইটেলমেন্ট)

ফিচার হলো অ্যাক্সেস-কন্ট্রোলের মূল উপাদান। একবার একটি ফিচার তৈরি করো, তারপর এটি এক বা একাধিক পণ্যে যুক্ত করো।

// Create a feature
const pro = await proyecta.commerce.features.create({
    name: 'Pro features',
    description: 'Unlocks the Pro tier capabilities',
    // optional custom id — lowercase alphanumeric and underscores only (e.g. 'pro_features')
});

যখন তুমি একটি পণ্য তৈরি করো, তখন “resources”-এর মাধ্যমে এতে ফিচার যুক্ত করো। যেসব গ্রাহক কোনো পণ্য সাবস্ক্রাইব করেন, তারা সেই পণ্যে যুক্ত প্রতিটি ফিচারে অ্যাক্সেস পান।

এরপর, তোমার অ্যাপে চেক করো কোনো গ্রাহকের অ্যাক্সেস আছে কিনা:

const { has_access } = await proyecta.commerce.check({
    customer_id: 'cus_123',
    resource_id: 'pro_features',
});

নোট: resource_id অবশ্যই ফিচার কী হতে হবে — ফিচারের নাম থেকে তৈরি slug (যেমন, pro_features), features.create() দ্বারা রিটার্ন করা ফিচার অবজেক্টের .id প্রপার্টি নয়।

এইভাবে তুমি তোমার অ্যাপ কোডে Pro-only পেজ, API endpoint, বা ফিচার গেট করতে পারবে।

সাধারণ পণ্যের ধরন

SaaS সাবস্ক্রিপশন

Create products: Free ($0/month), Pro ($29/month, $290/year), Business ($99/month, $990/year).
Attach a 'pro_features' feature to Pro and Business so I can gate access in my code.

ফিজিক্যাল পণ্য

Create a T-shirt product with three variants: Small, Medium, Large at $25 each.

ডিজিটাল পণ্য

Create a course product with a single one-time variant at $149.

ডোনেশন

Create a donation product with three variants: $25, $50, $100 — all one-time.

ইনভেন্টরি

Proyecta Commerce বর্তমানে ফিজিক্যাল পণ্যের জন্য ইনভেন্টরি ট্র্যাক করে না। যদি তুমি স্টকড আইটেম বিক্রি করো, তোমার অ্যাপের ডেটাবেজে স্টক গণনা পরিচালনা করো এবং checkout flow-এ সেগুলো চেক করো।

শীঘ্রই আসছে

• Checkout ফিল্ড কাস্টমাইজেশন — ক্রেতাদের কাছ থেকে অতিরিক্ত তথ্য সংগ্রহ করো
• পে-হোয়াট-ইউ-ওয়ান্ট মূল্য নির্ধারণ
• ফিজিক্যাল পণ্যের জন্য বিল্ট-ইন ইনভেন্টরি ট্র্যাকিং