Uygulamama Ticaret Entegre Et

Uygulama kodundan doğrudan checkout başlat ve premium özellikleri kısıtla.

Stripe’ı bağlayıp bir ürün oluşturduktan sonra uygulaman ödeme alabilir. Proyecta ile geliştirilen bir uygulamada bu, tarayıcıdan herkese açık ticaret API’sine karşı çalışır — ayağa kaldırman gereken bir backend yoktur ve işin içinde hiçbir gizli anahtar bulunmaz.

Mağaza katalogları içeriktir. Ürünlerin içerik destekli bir satılabilir koleksiyonsa (bkz. Ürünler ve Özellikler), kataloğu okur ve fiyatları İçerik API’si aracılığıyla render edersin — ürün verileri orada bulunur. Checkout’u yine aynı şekilde başlatırsın; entegre edilmiş Commerce ürününün variant_id’sini geçirirsin.

import * as platform from '@/lib/platformClient.ts';
import { useEntitlement } from '@/hooks/useEntitlement.ts';

Checkout Başlat

commerceCheckout, Stripe tarafından barındırılan bir checkout oturumu oluşturur ve alışveriş yapanı yönlendireceğin bir URL döndürür. Önce müşteri oluşturman gerekmez — platform, müşteriyi checkout’un kendisinden kaydeder:

const { url } = await platform.commerceCheckout({
    lineItems: [{ variantId: 'var_pro_monthly', quantity: 1 }],
    successUrl: 'https://myapp.com/welcome',
    cancelUrl: 'https://myapp.com/pricing',
    customerEmail: shopperEmail, // optional — prefills Stripe checkout
});

window.location.href = url;

Birden fazla satır öğesi desteklenir. Aboneliklerde quantity, koltuk sayısıdır. Alışveriş yapan bir kupon kodu yazdıysa onu da ilet — sunucu kodu doğrular ve indirimi commerce verilerinden hesaplar, asla tarayıcının bildirdiği bir tutardan değil.

Premium Bir Özelliği Kısıtla

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

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

Anahtar, özellik nesnesinin id’si değil, özelliğin slug’ıdır (örn. pro_features). Kontrol sunucu tarafındadır ve oturum açmış oturuma bağlıdır; bu nedenle tarayıcıdan taklit edilemez. Yetki modeli için bkz. Ürünler ve Özellikler.

Yapay Zekânın Bağlamasına İzin Ver

• "Build a /pricing page that shows my products and starts a checkout when a button is clicked."
• "Gate the /pro route so only customers with pro_features access can see it."
• "Add a cart with a coupon code field and a Checkout button."