Plačila (b77.payments)
Sprejemaj enkratna plačila in naročnine na svoj račun Stripe ali Whop.
Aplikacija lahko sprejema enkratna plačila in naročnine, ki gredo naravnost na tvoj račun Stripe ali Whop. builder77 ne zaračunava provizije. Na voljo od paketa Starter naprej.
1. Poveži Stripe ali Whop
V urejevalniku odpri Nastavitve → Plačila (pod Napredne nastavitve) in poveži enega ponudnika ali oba. Ključi so shranjeni šifrirano.
- Stripe: prilepi svoj skrivni ključ (Developers → API keys). Med testiranjem uporabi ključ
sk_test_…. - Whop: v nadzorni plošči Whop odpri Developer in ustvari API ključ podjetja z dovoljenji za plačila, pakete, izdelke in checkout. Vnesi ga skupaj z ID-jem podjetja, ki se začne z
biz_in ga vidiš v naslovni vrstici nadzorne plošče. Vklopi Sandbox, da plačila preizkusiš brez pravega denarja.
Če povežeš oba, izberi, katerega naj uporabljajo plačila. Koda aplikacije ostane v obeh primerih enaka.
2. Začni plačilo
// 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)Cene se vedno preberejo na strežniku, iz zapisa v zbirki s pravilom readonly (s poljema name in price). Namesto zapisa lahko podaš Stripe Price ID (price_…, samo Stripe) ali ID paketa Whop (plan_…, samo Whop, enega na plačilo).
Obiskovalca preusmeri na varno plačilno stran ponudnika, potem pa se vrne na isti zaslon. Lahko pa preprosto prosiš builder77: »dodaj gumb Kupi, ki zaračuna 15 $ na vadbo«.
3. Preveri rezultat
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Naročnine
// 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 pageNaročnine delujejo z obema ponudnikoma; kupec mora biti prijavljen. b77.payments.manage() odpre Stripov portal za obračun ali kupčevo stran članstva v Whopu. Če želiš, da plačljiva vsebina ostane zaklenjena na strežniku, jo shrani v zbirko s pravilom members ali members-private.
Zapisi plačil
Vsako plačilo se shrani v zbirko payments tvoje aplikacije s poljem status (pending, paid, expired), amount, currency, items in metadata, vidiš pa ga na zavihku Podatki. Vsako plačilo porabi 1 kredit za integracije.