Backend și SDK

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 page

Abonamentele 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.