Zaledje in SDK

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 page

Naroč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.