Backend ve SDK

Ödemeler (b77.payments)

Kendi Stripe ya da Whop hesabınla tek seferlik ödemeler ve abonelikler al.

Uygulaman tek seferlik ödeme ve abonelik alabilir; para doğrudan kendi Stripe ya da Whop hesabına geçer. builder77 platform ücreti almaz. Starter ve üstü planlarda var.

1. Stripe'ı ya da Whop'u bağla

Oluşturucuda Ayarlar → Ödemeler'i (Gelişmiş ayarlar altında) aç ve sağlayıcılardan birini ya da ikisini birden bağla. Anahtarlar sunucuda şifreli olarak saklanır.

  • Stripe: Stripe gizli anahtarını yapıştır (Developers → API keys). Test ederken sk_test_… anahtarı kullan.
  • Whop: Whop panelinde Developer bölümünü aç ve ödeme, plan, ürün ve checkout izinleri olan bir şirket API anahtarı oluştur. Bu anahtarı şirket kimliğinle birlikte gir; kimlik biz_ ile başlar ve panelin adres çubuğunda görünür. Gerçek para kullanmadan test ödemeleri yapmak için Sandbox'ı aç.

İkisi de bağlıysa ödemelerde hangisinin kullanılacağını seç. Uygulamanın kodu her iki durumda da aynı kalır.

2. Ödeme başlat

// b77.config.json: { "rules": { "classes": "readonly" } }
// a 'classes' record: { name: 'Yoga drop-in class', price: 15, currency: 'usd' }
await b77.payments.checkout({
  items: [{ collection: 'classes', id: classId, qty: 1 }], // the price is read on the server
  metadata: { note: 'Bring a mat' },
});
// or a price made at your provider:
// items: [{ price: 'price_123', qty: 1 }] (Stripe) / items: [{ price: 'plan_123' }] (Whop)

Fiyatlar her zaman sunucuda okunur: readonly kuralı olan bir koleksiyondaki kayıttan (name ve price alanlarıyla). Kayıt yerine bir Stripe Price ID (price_…, yalnızca Stripe) ya da bir Whop plan ID (plan_…, yalnızca Whop, ödeme başına bir tane) de verebilirsin.

Ziyaretçi sağlayıcının güvenli ödeme sayfasına gider, ödemeden sonra aynı ekrana döner. Kodla uğraşmak istemiyorsan builder77'ye söylemen yeterli: “ders başına 15 $ alan bir Satın al düğmesi ekle”.

3. Sonucu kontrol et

const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');

Abonelikler

// b77.config.json: { "rules": { "plans": "readonly", "lessons": "members" } }
// a 'plans' record: { name: 'Pro', price: 9, currency: 'usd', interval: 'month' }
await b77.payments.subscribe({ items: [{ collection: 'plans', id: planId, qty: 1 }] });

const { active } = await b77.payments.subscription(); // show or hide paywall UI
await b77.payments.manage(); // Stripe billing portal or the buyer's Whop membership page

Abonelikler iki sağlayıcıyla da çalışır; alıcının giriş yapmış olması gerekir. b77.payments.manage() Stripe müşteri portalını ya da alıcının Whop üyelik sayfasını açar. Ücretli içeriği sunucuda kilitli tutmak için onu members ya da members-private kuralı olan bir koleksiyona koy.

Ödeme kayıtları

Her ödeme uygulamanın payments koleksiyonuna status (pending, paid, expired), amount, currency, items ve metadata ile kaydedilir; bunları Veriler sekmesinde görürsün. Her ödeme 1 entegrasyon kredisi kullanır.