Platby (b77.payments)
Přijímej jednorázové platby i předplatné na vlastní účet Stripe nebo Whop.
Nech aplikaci přijímat jednorázové platby i předplatné, které jdou rovnou na tvůj vlastní účet Stripe nebo Whop. builder77 si nebere žádný poplatek. K dispozici od tarifu Starter.
1. Připoj Stripe nebo Whop
V editoru otevři Nastavení → Platby (v Pokročilých nastaveních) a připoj jednoho poskytovatele nebo oba. Klíče se ukládají šifrovaně.
- Stripe: vlož svůj tajný klíč Stripe (Developers → API keys). Při testování použij klíč
sk_test_…. - Whop: v nástěnce Whop otevři Developer a vytvoř firemní API klíč s oprávněními pro platby, plány, produkty a checkout. Zadej ho spolu s ID své firmy, které začíná na
biz_a najdeš ho v adresním řádku nástěnky. Když chceš testovat platby bez skutečných peněz, zapni Sandbox.
Když připojíš oba, vyber, přes který mají platby probíhat. Kód aplikace zůstává v obou případech stejný.
2. Spusť 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 se vždy čtou na serveru ze záznamu v kolekci s pravidlem readonly (s poli name a price). Místo záznamu můžeš předat Stripe Price ID (price_…, jen Stripe) nebo ID plánu Whop (plan_…, jen Whop, jedno na platbu).
Návštěvník se přesměruje na zabezpečenou platební stránku tvého poskytovatele a pak se vrátí na stejnou obrazovku. Nebo prostě požádej builder77: „přidej tlačítko Koupit, které účtuje 15 $ za lekci“.
3. Zkontroluj výsledek
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Předplatné
// 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 pagePředplatné funguje s oběma poskytovateli; kupující musí být přihlášený. b77.payments.manage() otevře zákaznický portál Stripe nebo stránku členství kupujícího ve Whopu. Aby placený obsah zůstal zamčený na serveru, ulož ho do kolekce s pravidlem members nebo members-private.
Záznamy plateb
Každá platba se uloží do kolekce payments tvé aplikace s poli status (pending, paid, expired), amount, currency, items a metadata a uvidíš ji v záložce Data. Každá platba spotřebuje 1 integrační kredit.