Taustasüsteem ja SDK

Maksed (b77.payments)

Võta vastu ühekordseid makseid ja tellimusi oma Stripe’i või Whopi kontoga.

Lase rakendusel võtta vastu ühekordseid makseid ja tellimusi, mis laekuvad otse sinu enda Stripe’i või Whopi kontole. builder77 platvormitasu ei võta. Saadaval alates paketist Starter.

1. Ühenda Stripe või Whop

Ava redaktoris Seaded → Maksed (Täpsemad seaded all) ja ühenda üks teenusepakkuja või mõlemad. Võtmed salvestatakse krüpteeritult.

  • Stripe: kleebi oma salavõti (Developers → API keys). Testimise ajal kasuta võtit sk_test_….
  • Whop: ava Whopi juhtpaneelis Developer ja loo ettevõtte API-võti maksete, pakettide, toodete ja checkout'i õigustega. Sisesta see koos ettevõtte ID-ga, mis algab tähtedega biz_ ja on näha juhtpaneeli aadressiribal. Lülita sisse Sandbox, et teha testmakseid ilma päris rahata.

Kui mõlemad on ühendatud, vali, kumba makseteks kasutatakse. Rakenduse kood jääb mõlemal juhul samaks.

2. Alusta makset

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

Hinnad loetakse alati serveris kirjest, mis asub reegliga readonly kogumikus (väljadega name ja price). Kirje asemel saab kasutada ka Stripe’i Price ID-d (price_…, ainult Stripe) või Whopi paketi ID-d (plan_…, ainult Whop, üks makse kohta).

Külastaja suunatakse teenusepakkuja turvalisele makselehele ja pärast maksmist naaseb ta samale ekraanile. Võid ka lihtsalt builder77-lt paluda: „lisa Osta-nupp, mis võtab tunni eest 15 $“.

3. Kontrolli tulemust

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

Tellimused

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

Tellimused töötavad mõlema teenusepakkujaga; ostja peab olema sisse logitud. b77.payments.manage() avab Stripe’i kliendiportaali või ostja Whopi liikmelisuse lehe. Et tasuline sisu jääks serveris lukku, pane see kogumikku reegliga members või members-private.

Maksekirjed

Iga makse salvestatakse rakenduse kogumikku payments väljadega status (pending, paid, expired), amount, currency, items ja metadata ning selle näed vahekaardil Andmed. Iga makse kulutab 1 integratsioonikrediidi.