Maksājumi (b77.payments)
Pieņem vienreizējus maksājumus un abonementus savā Stripe vai Whop kontā.
Lietotne var pieņemt vienreizējus maksājumus un abonementus, un nauda nonāk tieši tavā Stripe vai Whop kontā. builder77 neiekasē platformas komisiju. Pieejams no Starter plāna.
1. Pievieno Stripe vai Whop
Redaktorā atver Iestatījumi → Maksājumi (zem Papildu iestatījumi) un pievieno vienu pakalpojumu sniedzēju vai abus. Atslēgas glabājas šifrētas.
- Stripe: ielīmē savu slepeno atslēgu (Developers → API keys). Testēšanas laikā izmanto
sk_test_…atslēgu. - Whop: Whop informācijas panelī atver Developer un izveido uzņēmuma API atslēgu ar atļaujām maksājumiem, plāniem, produktiem un checkout. Ievadi to kopā ar uzņēmuma ID, kas sākas ar
biz_un ir redzams paneļa adreses joslā. Ieslēdz Sandbox, lai testētu maksājumus bez īstas naudas.
Ja pievieno abus, izvēlies, kuru izmantot maksājumiem. Lietotnes kods abos gadījumos paliek tāds pats.
2. Sāc maksājumu
// 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)Cenas vienmēr nolasa serverī no ieraksta kolekcijā ar noteikumu readonly (ar name un price). Ieraksta vietā vari norādīt Stripe Price ID (price_…, tikai Stripe) vai Whop plāna ID (plan_…, tikai Whop, viens katram maksājumam).
Apmeklētājs nonāk pakalpojuma sniedzēja drošajā maksājumu lapā un pēc tam atgriežas tajā pašā ekrānā. Vai vienkārši palūdz builder77: „pievieno pogu Pirkt, kas iekasē 15 $ par nodarbību“.
3. Pārbaudi rezultātu
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Abonementi
// 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 pageAbonementi darbojas ar abiem pakalpojumu sniedzējiem; pircējam jābūt pieteikušamies. b77.payments.manage() atver Stripe norēķinu portālu vai pircēja Whop dalības lapu. Lai maksas saturs paliktu slēgts jau serverī, glabā to kolekcijā ar noteikumu members vai members-private.
Maksājumu ieraksti
Katrs maksājums saglabājas lietotnes kolekcijā payments ar status (pending, paid, expired), amount, currency, items un metadata, un to vari redzēt cilnē Dati. Katrs maksājums izmanto 1 integrāciju kredītu.