Platby (b77.payments)
Prijímaj jednorazové platby aj predplatné na vlastný účet Stripe alebo Whop.
Tvoja aplikácia môže prijímať jednorazové platby aj predplatné a peniaze idú priamo na tvoj vlastný účet Stripe alebo Whop. builder77 si neberie žiadny poplatok platformy. K dispozícii od plánu Starter.
1. Pripoj Stripe alebo Whop
V editore otvor Nastavenia → Platby (v časti Rozšírené nastavenia) a pripoj jedného poskytovateľa alebo oboch. Kľúče sa ukladajú šifrované.
- Stripe: vlož svoj tajný kľúč (Developers → API keys). Pri testovaní použi kľúč
sk_test_…. - Whop: v nástenke Whop otvor Developer a vytvor firemný API kľúč s oprávneniami na platby, plány, produkty a checkout. Zadaj ho spolu s ID svojej firmy, ktoré sa začína na
biz_a nájdeš ho v adresnom riadku nástenky. Ak chceš testovať platby bez skutočných peňazí, zapni Sandbox.
Ak pripojíš oboch, vyber, ktorého majú platby používať. Kód aplikácie zostáva v oboch prípadoch rovnaký.
2. Spusti platbu
// 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)Ceny sa vždy čítajú na serveri, zo záznamu v kolekcii s pravidlom readonly (s poľami name a price). Namiesto záznamu môžeš odovzdať Stripe Price ID (price_…, len Stripe) alebo ID plánu Whop (plan_…, len Whop, jedno na platbu).
Návštevník prejde na zabezpečenú platobnú stránku tvojho poskytovateľa a potom sa vráti na tú istú obrazovku. Alebo stačí napísať builder77: „pridaj tlačidlo Kúpiť, ktoré účtuje 15 $ za hodinu“.
3. Skontroluj výsledok
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Predplatné
// 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 pagePredplatné funguje s oboma poskytovateľmi; kupujúci musí byť prihlásený. b77.payments.manage() otvorí zákaznícky portál Stripe alebo stránku členstva kupujúceho vo Whope. Aby platený obsah zostal zamknutý na serveri, ulož ho do kolekcie s pravidlom members alebo members-private.
Záznamy platieb
Každá platba sa uloží do kolekcie payments tvojej aplikácie s poľami status (pending, paid, expired), amount, currency, items a metadata a nájdeš ju na karte Dáta. Každá platba minie 1 kredit za integrácie.