For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/web/billing.md (or send Accept: text/markdown).
Ödemeler ve abonelikler
Stripe checkout, plan yönetimi ve yetkilendirme sınırı.
Ödeme hizmetinizi seçin ve test edin
Faturalandırma, ödemeleri yönetir. Erişim izinleri, yetkiler olarak ayrı olarak depolanır. Kalıcı hesap kurulumunu tamamlayın, ardından plan arayüzünü görmek için çalışan Web uygulamasında /billing'i açın. BILLING_PROVIDER=local ile gerçek para toplamak yerine yerel davranışları keşfediyorsunuz.
Desteklenen bir ödeme sağlayıcısını seçin, kurulum kılavuzunu izleyin, kendi test ürününüzü ve fiyatınızı oluşturun ve adlandırılmış sunucu ayarlarını apps/web/.env.local.'ye kopyalayın Kaydedip Web sunucusunu yeniden başlatın. Bu sağlayıcının korumalı alan talimatlarını kullanarak bir ödeme işlemini tamamlayın ve ardından sağlayıcının web kancası geldikten sonra çalışma alanının erişim durumunu inceleyin. Web kancası, sağlayıcının bir ödeme etkinliği hakkında sunucunuza gönderdiği imzalı mesajdır.
Başarılı bir sayfa tek başına özelliklerin kilidini açmaz. Ödeme tamamlanır ancak erişim etkin değilse, ödemeyi tekrarlamadan önce sağlayıcının webhook dağıtımını ve sunucunuzun olay işlemesini kontrol edin. Test iptali ve süresi dolmuş erişim de. Telefonla satın alma işlemleri bu Web ödemesini değil, ayrı RevenueCat/mağaza kurulumunu kullanır.
Web faturalandırma
Web uygulaması, BILLING_PROVIDER ile seçtiğiniz faturalandırma sağlayıcısını destekler; Şerit bir seçenektir. Web planları ve abonelik yönetimi için açma/faturalandırma. Eşleştirme testi veya canlı ortamda yalnızca sunucu kimlik bilgilerini, ürün veya fiyat kimliklerini ve web kancası doğrulama ayarlarını belirlemek için seçilen sağlayıcının kılavuzunu izleyin.
Yetkilendirmeler üzerinden izin verin
Checkout yönlendirmesi etkin erişim kanıtı değildir. Sunucuya ait yetkilendirme, çalışma alanının ücretli yeteneği kullanıp kullanamayacağına karar verir. Arayüz eylemi zaten gizlese bile yetkilendirmeyi eylem sınırında kontrol edin.
Yaşam döngüsünü doğrulayın
Etkinleştirme, güncellemeler, iptal ve webhook işlemeyi doğrulamak için sanal ortam olaylarını kullanın. Tekrarlanan olayları güvenli tutun ve etkin olmayan yetkilendirmenin ücretli işlemleri engellediğinden emin olun. Yerel mobil satın alımlar ayrı bir RevenueCat entegrasyon sınırı olarak kalır.
Kurulum ve yapılandırma
Plan kataloğu src/product-plans.ts içinde yaşar ve /billing yüzeyi ile /choose-plan onboarding adımını besler. Faturalama sunucu tarafında BILLING_PROVIDER=stripe, STRIPE_SECRET_KEY, her plan ve aralık için fiyat kimlikleri ve STRIPE_WEBHOOK_SECRET ile yapılandırılır. Lemon Squeezy alternatif bağdaştırıcı olarak mevcuttur.
Koltuk tabanlı planlar düzenlenebilir koltuk sayaçlarını (src/seat-count.ts) kullanır; miktar ödeme oturumuyla birlikte iletilir, böylece faturalandırılan koltuklar çalışma alanıyla eşleşir. Planlar ayrıca src/product-plans.ts içinde meteredUsage tanımlayabilir; böylece saatlik billing.usage-report görevi usage_counter farklarını Stripe faturalandırma sayaçlarına bildirirken, çalışma alanı sahipleri Ayarlar → Kullanım (src/usage-meters.ts içindeki USAGE_METERS) altından aylık yapay zeka bütçelerini ve sayaç başına kesin üst sınırları belirler.
Checkout: POST /api/billing/checkout
Portal: POST /api/billing/portal
Webhook: POST /api/billing/webhook (signature-verified)Uygulama iş akışı
Checkout yönlendirmesi yalnızca bekleyen bir niyettir — erişim, imzalı webhook geldiğinde ve sunucuya ait yetkilendirme güncellendiğinde değişir. Arayüz eylemleri zaten gizlese bile ücretli eylemleri sunucu sınırındaki yetkilendirme kontrolüyle (entitlement-gate.tsx / entitlement-check.ts) kapılayın.
Müşteri portalı plan değişikliklerini, iptali ve ödeme yöntemlerini yönetir. Abonelik durumunu çalışma alanı üyeleri tarafından okunabilir tutun ve yerel mobil satın alımları ayrı RevenueCat sınırının arkasında tutun.