מוצרים ותכונות

הגדר מה אתה מוכר. צור מוצרים עם גרסאות אחת או יותר, וצרף תכונות לשימוש חוזר לבקרת גישה מבוססת-הרשאות.

Proyecta Commerce משתמשת בשלושה מושגים: מוצרים, גרסאות, ותכונות.

• מוצר — הדבר שאתה מוכר (למשל “Pro Plan”, “חולצת טי”, “ייעוץ אסטרטגי”)
• גרסה — רמת מחיר או תצורה של מוצר (למשל “Pro חודשי $29”, “Pro שנתי $290”, “חולצת טי – גדולה”)
• תכונה — מפתח הרשאה לשימוש חוזר שהאפליקציה שלך בודקת בזמן ריצה (למשל 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 תומך ב-130+)
unit_amount	מחיר ביחידת המטבע הקטנה ביותר (סנטים). 2900 = $29.00
recurring	אופציונלי — { interval: 'week' | 'month' | 'year' }. השמט עבור מחירים חד-פעמיים. חיוב יומי אינו נתמך כרגע.
is_default	מתקבל אך לא נאכף עדיין — בחירת גרסה ברירת מחדל אינה מיושמת כרגע.
media	צרף תמונות או סרטונים לפי מזהה קובץ CDN (ראה קבצים)

התמחור אינו ניתן לשינוי. לאחר יצירת גרסה, לא ניתן לשנות את מחירה — במקום זאת, צור גרסה חדשה. הדבר מגן על מנויים קיימים משינויי מחיר בשוגג.

תכונות (הרשאות)

תכונות הן הרכיב הבסיסי לבקרת גישה. צור תכונה פעם אחת, ולאחר מכן צרף אותה למוצר אחד או יותר.

// 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')
});

כשאתה יוצר מוצר, אתה מצרף אליו תכונות דרך “משאבים”. לקוחות שנרשמים למנוי על מוצר מקבלים גישה לכל תכונה המצורפת אליו.

לאחר מכן, באפליקציה שלך, בדוק האם ללקוח יש גישה:

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

שים לב: ה-resource_id חייב להיות המפתח של התכונה — ה-slug הנגזר משם התכונה (למשל, pro_features), ולא מאפיין ה-.id של אובייקט התכונה שמוחזר על ידי features.create().

כך תגביל גישה לדפים, endpoint-ים ב-API, או תכונות הזמינות רק ל-Pro בקוד האפליקציה שלך.

צורות מוצר נפוצות

מנויי 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.

בקרוב

• התאמה אישית של שדות ב-checkout — איסוף מידע נוסף מהקונים
• תמחור לפי שיקול דעת הקונה
• מעקב מלאי מובנה למוצרים פיזיים