Backend i SDK

Plaćanja (b77.payments)

Primaj jednokratna plaćanja i pretplate na vlastiti Stripe ili Whop račun.

Omogući aplikaciji da prima jednokratna plaćanja i pretplate, izravno na tvoj Stripe ili Whop račun. builder77 ne uzima nikakvu proviziju. Dostupno od paketa Starter naviše.

1. Poveži Stripe ili Whop

U uređivaču otvori Postavke → Plaćanja (u Napredne postavke) i poveži jednog pružatelja ili oba. Ključevi se pohranjuju šifrirano.

  • Stripe: zalijepi svoj tajni Stripe ključ (Developers → API keys). Dok testiraš, koristi ključ sk_test_….
  • Whop: u Whop nadzornoj ploči otvori Developer i izradi API ključ tvrtke s dopuštenjima za plaćanja, planove, proizvode i checkout. Unesi ga zajedno s ID-jem svoje tvrtke, koji počinje s biz_ i vidi se u adresnoj traci nadzorne ploče. Uključi Sandbox za testna plaćanja bez pravog novca.

Ako povežeš oba, odaberi koji će se koristiti za plaćanja. Kôd aplikacije ostaje isti u oba slučaja.

2. Pokreni plaćanje

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

Cijene se uvijek čitaju na poslužitelju, iz zapisa u kolekciji s pravilom readonly (s poljima name i price). Umjesto zapisa možeš proslijediti Stripe Price ID (price_…, samo Stripe) ili ID Whop plana (plan_…, samo Whop, jedan po plaćanju).

Posjetitelj se preusmjerava na sigurnu stranicu za plaćanje tvog pružatelja usluge i nakon toga se vraća na isti zaslon. Ili samo zamoli builder77: „dodaj gumb Kupi koji naplaćuje 15 $ po terminu”.

3. Provjeri rezultat

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

Pretplate

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

Pretplate rade s oba pružatelja usluge; kupac mora biti prijavljen. b77.payments.manage() otvara Stripeov korisnički portal ili kupčevu stranicu članstva na Whopu. Da bi plaćeni sadržaj ostao zaključan na poslužitelju, stavi ga u kolekciju s pravilom members ili members-private.

Zapisi o plaćanjima

Svako plaćanje sprema se u kolekciju payments tvoje aplikacije s poljima status (pending, paid, expired), amount, currency, items i metadata, a vidiš ga na kartici Podaci. Svako plaćanje troši 1 kredit za integracije.