Aizmugursistēma un SDK

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 page

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