Backend és SDK

Fizetések (b77.payments)

Fogadj egyszeri fizetéseket és előfizetéseket a saját Stripe- vagy Whop-fiókoddal.

Az alkalmazásod egyszeri fizetéseket és előfizetéseket fogadhat, közvetlenül a saját Stripe- vagy Whop-fiókodba. A builder77 nem számol fel platformdíjat. A Starter csomagtól érhető el.

1. Kösd be a Stripe-ot vagy a Whopot

A szerkesztőben nyisd meg a Beállítások → Fizetések részt (a Speciális beállítások alatt), és kösd be az egyik szolgáltatót vagy mindkettőt. A kulcsokat titkosítva tároljuk.

  • Stripe: illeszd be a titkos Stripe-kulcsodat (Developers → API keys). Teszteléshez sk_test_… kulcsot használj.
  • Whop: a Whop irányítópultján nyisd meg a Developer részt, és hozz létre céges API-kulcsot fizetés, csomag, termék és checkout jogosultsággal. Add meg a cégazonosítóddal együtt, amely biz_ előtaggal kezdődik, és az irányítópult címsorában látható. Ha valódi pénz nélkül szeretnél fizetést tesztelni, kapcsold be a Sandbox módot.

Ha mindkettőt bekötötted, válaszd ki, melyiken keresztül menjenek a fizetések. Az alkalmazásod kódja mindkét esetben ugyanaz marad.

2. Indíts fizetést

// 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)

Az árakat mindig a szerver olvassa ki, egy readonly szabályú gyűjtemény rekordjából (name és price mezővel). Rekord helyett megadhatsz Stripe Price ID-t (price_…, csak Stripe) vagy Whop-csomagazonosítót (plan_…, csak Whop, fizetésenként egyet).

A látogató a szolgáltatód biztonságos fizetési oldalára kerül, utána pedig visszatér ugyanarra a képernyőre. De egyszerűen meg is kérheted a builder77-et: „adj hozzá egy Vásárlás gombot, amely egy óráért 15 dollárt számol fel”.

3. Ellenőrizd az eredményt

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

Előfizetések

// 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

Az előfizetések mindkét szolgáltatóval működnek; a vásárlónak be kell jelentkeznie. A b77.payments.manage() megnyitja a Stripe számlázási portálját vagy a vásárló Whop-tagsági oldalát. Ha azt szeretnéd, hogy a fizetős tartalom a szerveren zárva maradjon, tedd egy members vagy members-private szabályú gyűjteménybe.

Fizetési rekordok

Minden fizetés bekerül az alkalmazásod payments gyűjteményébe a status (pending, paid, expired), amount, currency, items és metadata mezőkkel, és az Adatok fülön meg is nézheted. Minden fizetés 1 integrációs kreditbe kerül.