Ürünler ve Özellikler

Ne sattığınızı tanımlayın. Bir veya daha fazla varyantla ürünler oluşturun, hak tabanlı erişim kontrolü için yeniden kullanılabilir özellikler ekleyin.

Proyecta Commerce üç kavram kullanır: ürünler, varyantlar ve özellikler.

• Ürün — sattığınız şey (ör. “Pro Plan”, “T-shirt”, “Strateji Görüşmesi”)
• Varyant — bir ürünün fiyatlandırma kademesi veya yapılandırması (ör. “Pro Aylık $29”, “Pro Yıllık $290”, “T-shirt – Large”)
• Özellik — uygulamanızın çalışma zamanında kontrol ettiği, yeniden kullanılabilir bir hak anahtarı (ör. pro_features, unlimited_projects, api_access)

Bir ürünün birden fazla varyantı olabilir. Bir ürüne aynı zamanda bir veya daha fazla kaynak da eklenir; bu kaynaklar genellikle özelliklerdir ve bir müşteri abone olduğunda erişim sağlar.

Sattığınız şeyi modellemenin iki yolu

Commerce, platformun geri kalanıyla birlikte çalışır; bu nedenle “satılan bir şey” için iki farklı yapı vardır — Proyecta sizin için doğru olanı seçer:

• Commerce’e özgü ürünler — abonelikler, planlar, tek seferlik yükseltmeler ve özellikler/haklar. Doğrudan Admin > Commerce > Products bölümünde tanımlanır. Bu sayfanın geri kalanında açıklanan model budur.
• İçerik destekli bir vitrin kataloğu — bir işletme sahibinin her gün düzenlediği fotoğraflı, fiyatlı ve açıklamalı ürünler. Bunlar CMS’de satılabilir bir koleksiyon olarak yer alır: her giriş bir üründür. Bir giriş yayımlandığında, Proyecta onu otomatik olarak Commerce’e gerçek, satın alınabilir bir ürün olarak entegre eder — ürünü ve fiyatlandırılmış varyantını sizin için oluşturur, fiyatı doğrudan içerik alanından kopyalar. Vitrin içerik fiyatını gösterir, ödeme ise bağlı varyant üzerinden gerçekleşir; tek bir kaynağı paylaştıkları için hiçbir zaman birbirinden sapmazlar. Bu öğeleri Commerce > Products altında değil, içerik olarak (uygulamanızın Admin panelinde, builder’da veya yayımlanmış sitenizde) yönetirsiniz. Bkz. İçerik Yönetimi.

Kart ödemesi almayan sıradan bir katalog — yalnızca görüntüleme amaçlı bir menü ya da “satın al” düğmesi WhatsApp sipariş bağlantısı açan bir mağaza — Commerce entegrasyonu olmayan sıradan bir içeriktir, yani sıradan bir katalog koleksiyonudur. Bir koleksiyonu satılabilir kılan şey kart ödemesidir.

Ürün oluşturma

Admin > Commerce > Products bölümünde Create product düğmesine tıklayın (veya AI’ya sorun: "Create a Pro plan at $29/month and a Business plan at $99/month."). Her ürün için şunlar gereklidir:

• Bir görünen ad (ör. “Pro”)
• En az bir varyant

Varyantlar

Her varyant kendi fiyatlandırmasını taşır:

Alan	Notlar
name	Varyant için görünen etiket (“Monthly”, “Annual”, “Large”)
currency	Üç harfli ISO kodu — USD, EUR, GBP, JPY, BRL, MXN, INR… (130’dan fazla desteklenir)
unit_amount	En küçük para birimi cinsinden fiyat (kuruş). 2900 = $29.00
recurring	İsteğe bağlı — { interval: 'week' | 'month' | 'year' }. Tek seferlik fiyatlar için belirtmeyin. Günlük faturalandırma şu an desteklenmemektedir.
is_default	Kabul edilir ancak henüz uygulanmamıştır — varsayılan varyant seçimi şu an aktif değildir.
media	CDN dosya ID’si ile resim veya video ekleyin (bkz. Dosyalar)

Fiyatlandırma değiştirilemez. Bir varyant oluşturulduktan sonra fiyatı değiştirilemez — bunun yerine yeni bir varyant oluşturun. Bu, mevcut abonelerin kazara fiyat değişikliklerine karşı korunmasını sağlar.

Özellikler (haklar)

Özellikler, erişim kontrolünün temel birimidir. Admin > Commerce > Products bölümünde bir özelliği bir kez oluşturun, ardından bir veya daha fazla ürüne ekleyin. Her özelliğin bir adı, isteğe bağlı bir açıklaması ve bir anahtarı vardır — küçük harfler, rakamlar ve alt çizgilerden oluşur (ör. pro_features) — uygulamanız bu anahtarı kontrol eder.

Bir ürün oluşturduğunuzda, özellikleri “kaynaklar” aracılığıyla eklersiniz. Bir ürüne abone olan müşteriler, o ürüne eklenmiş tüm özelliklere erişim kazanır.

Ardından uygulamanızda bu anahtarı kontrol edin:

const { hasAccess, isLoading } = useEntitlement('pro_features');

if (isLoading) return <Spinner />;
if (!hasAccess) return <UpgradePrompt />;
return <ProOnlyThing />;

Kontrol, oturum açmış kullanıcının oturumuna karşı sunucu tarafında çalışır; bu nedenle tarayıcıdan taklit edilemez. Tam örüntü için bkz. Commerce’i Uygulamama Entegre Etme.

Not: Her zaman özelliğin dahili id’si değil, özellik adından türetilen slug olan anahtar üzerinden kontrol yapın (ör. pro_features).

Uygulama kodunuzda yalnızca Pro kullanıcılara açık sayfaları, API endpoint’lerini veya özellikleri bu şekilde kısıtlarsınız.

Yaygın ürün yapıları

SaaS abonelikleri

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.

Fiziksel ürünler

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

Dijital ürünler

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

Bağışlar

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

Envanter

Proyecta Commerce şu an fiziksel ürünler için envanter takibi yapmamaktadır. Stoklu ürün satıyorsanız stok miktarlarını uygulamanızın veritabanında yönetin ve ödeme akışınızda kontrol edin.

Yakında

• Ödeme alanı özelleştirmesi — alıcılardan ek bilgi toplama
• İstediğin kadar öde fiyatlandırması
• Fiziksel ürünler için yerleşik envanter takibi