Backend u SDK

Ħlasijiet (b77.payments)

Aċċetta ħlasijiet ta' darba u abbonamenti bil-kont Stripe jew Whop tiegħek.

Ħalli l-app tiegħek tieħu ħlasijiet ta' darba u abbonamenti, imħallsa dritt fil-kont Stripe jew Whop tiegħek. builder77 ma jieħu l-ebda tariffa tal-pjattaforma. Disponibbli minn Starter 'il fuq.

1. Għaqqad Stripe jew Whop

Fil-builder iftaħ Issettjar → Ħlasijiet (taħt Issettjar avvanzat) u għaqqad fornitur wieħed jew it-tnejn. Iċ-ċwievet jinħażnu kriptati.

  • Stripe: agħmel paste tas-secret key tiegħek (Developers → API keys). Uża ċavetta sk_test_… waqt li tkun qed tittestja.
  • Whop: fid-dashboard ta' Whop iftaħ Developer u oħloq ċavetta API tal-kumpanija bil-permessi għall-ħlasijiet, il-pjanijiet, il-prodotti u l-checkout. Daħħalha flimkien mal-ID tal-kumpanija tiegħek, li jibda b'biz_ u jidher fil-bar tal-indirizz tad-dashboard. Ixgħel Sandbox biex tittestja l-ħlasijiet mingħajr flus veri.

Jekk tgħaqqad it-tnejn, agħżel liema wieħed jużaw il-ħlasijiet tiegħek. Il-kodiċi tal-app jibqa' l-istess fiż-żewġ każijiet.

2. Ibda ħlas

// 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)

Il-prezzijiet dejjem jinqraw fuq is-server, minn rekord f'kollezzjoni bir-regola readonly (b'name u price). Minflok rekord tista' tgħaddi Stripe Price ID (price_…, Stripe biss) jew ID ta' pjan ta' Whop (plan_…, Whop biss, wieħed għal kull ħlas).

Il-viżitatur jintbagħat fil-paġna tal-ħlas sigura tal-fornitur tiegħek u wara jerġa' lura għall-istess skrin. Jew sempliċement itlob lil builder77: "żid buttuna Ixtri li tiċċarġja $15 għal kull klassi".

3. Iċċekkja r-riżultat

const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');

Abbonamenti

// 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

L-abbonamenti jaħdmu maż-żewġ fornituri; ix-xerrej irid ikun dieħel fil-kont tiegħu. b77.payments.manage() jiftaħ il-portal tal-klijenti ta' Stripe jew il-paġna tas-sħubija ta' Whop tax-xerrej. Biex il-kontenut imħallas jibqa' msakkar fuq is-server, poġġih f'kollezzjoni bir-regola members jew members-private.

Rekords tal-ħlasijiet

Kull ħlas jinħażen fil-kollezzjoni payments tal-app tiegħek b'status (pending, paid, expired), amount, currency, items u metadata, u tista' tarah fit-tab Data. Kull ħlas juża 1 kreditu ta' integrazzjoni.