Mokėjimai (b77.payments)
Priimk vienkartinius mokėjimus ir prenumeratas į savo Stripe arba Whop paskyrą.
Programėlė gali priimti vienkartinius mokėjimus ir prenumeratas, o pinigai keliauja tiesiai į tavo Stripe arba Whop paskyrą. builder77 neima jokio platformos mokesčio. Galima nuo Starter plano.
1. Prijunk Stripe arba Whop
Redaktoriuje atidaryk Nustatymai → Mokėjimai (dalyje Išplėstiniai nustatymai) ir prijunk vieną teikėją arba abu. Raktai saugomi užšifruoti.
- Stripe: įklijuok savo slaptąjį raktą (Developers → API keys). Bandydamas naudok
sk_test_…raktą. - Whop: Whop skydelyje atidaryk Developer ir sukurk įmonės API raktą su mokėjimų, planų, produktų ir checkout leidimais. Įvesk jį kartu su įmonės ID: jis prasideda
biz_ir matyti skydelio adreso juostoje. Įjunk Sandbox, kad mokėjimus išbandytum be tikrų pinigų.
Jei prijungi abu, pasirink, kurį naudos mokėjimai. Programėlės kodas abiem atvejais nesikeičia.
2. Pradėk mokėjimą
// 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)Kainos visada nuskaitomos serveryje, iš įrašo kolekcijoje su taisykle readonly (su name ir price). Vietoj įrašo gali perduoti Stripe Price ID (price_…, tik Stripe) arba Whop plano ID (plan_…, tik Whop, vieną vienam mokėjimui).
Lankytojas nukreipiamas į saugų tavo teikėjo mokėjimo puslapį, o paskui grįžta į tą patį ekraną. Arba tiesiog paprašyk builder77: „pridėk mygtuką Pirkti, kuris už užsiėmimą nuskaičiuoja 15 $“.
3. Patikrink rezultatą
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Prenumeratos
// 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 pagePrenumeratos veikia su abiem teikėjais; pirkėjas turi būti prisijungęs. b77.payments.manage() atidaro Stripe klientų portalą arba pirkėjo Whop narystės puslapį. Kad mokamas turinys liktų užrakintas serveryje, laikyk jį kolekcijoje su taisykle members arba members-private.
Mokėjimų įrašai
Kiekvienas mokėjimas išsaugomas programėlės kolekcijoje payments su status (pending, paid, expired), amount, currency, items ir metadata, ir jį matai skiltyje Duomenys. Kiekvienas mokėjimas naudoja 1 integracijų kreditą.