Plăți (b77.payments)
Acceptă plăți unice și abonamente în propriul tău cont Stripe sau Whop.
Aplicația ta poate încasa plăți unice și abonamente, direct în propriul tău cont Stripe sau Whop. builder77 nu percepe niciun comision de platformă. Disponibil de la planul Starter în sus.
1. Conectează Stripe sau Whop
În editor, deschide Setări → Plăți (în Setări avansate) și conectează un furnizor sau pe amândoi. Cheile sunt stocate criptat.
- Stripe: lipește cheia secretă Stripe (Developers → API keys). Cât timp testezi, folosește o cheie
sk_test_…. - Whop: în panoul Whop, deschide Developer și creează o cheie API a companiei cu permisiuni pentru plăți, planuri, produse și checkout. Introdu-o împreună cu ID-ul companiei, care începe cu
biz_și apare în bara de adrese a panoului. Activează Sandbox ca să testezi plăți fără bani reali.
Dacă îi conectezi pe amândoi, alegi pe care îl folosesc plățile. Codul aplicației rămâne același în ambele cazuri.
2. Pornește o plată
// 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)Prețurile se citesc mereu pe server, dintr-o înregistrare aflată într-o colecție cu regula readonly (cu name și price). În locul unei înregistrări poți transmite un Price ID Stripe (price_…, doar Stripe) sau un ID de plan Whop (plan_…, doar Whop, unul per plată).
Vizitatorul este redirecționat către pagina de plată securizată a furnizorului și apoi revine pe același ecran. Sau cere-i pur și simplu lui builder77: „adaugă un buton Cumpără care încasează 15 $ pe curs”.
3. Verifică rezultatul
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Abonamente
// 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 pageAbonamentele funcționează cu ambii furnizori; cumpărătorul trebuie să fie autentificat. b77.payments.manage() deschide portalul de facturare Stripe sau pagina de abonament Whop a cumpărătorului. Ca să păstrezi conținutul plătit blocat pe server, pune-l într-o colecție cu regula members sau members-private.
Înregistrări de plată
Fiecare plată se salvează în colecția payments a aplicației, cu status (pending, paid, expired), amount, currency, items și metadata, și o poți vedea în fila Date. Fiecare plată folosește 1 credit de integrare.