Maksut (b77.payments)
Ota vastaan kertamaksuja ja tilauksia omalla Stripe- tai Whop-tililläsi.
Anna sovelluksesi ottaa vastaan kertamaksuja ja tilauksia suoraan omalle Stripe- tai Whop-tilillesi. builder77 ei peri alustamaksua. Saatavilla Starter-paketista alkaen.
1. Yhdistä Stripe tai Whop
Avaa editorissa Asetukset → Maksut (Lisäasetukset-kohdassa) ja yhdistä toinen palveluntarjoajista tai molemmat. Avaimet tallennetaan salattuina.
- Stripe: liitä Stripen salainen avaimesi (Developers → API keys). Käytä testatessa
sk_test_…-avainta. - Whop: avaa Whop-hallintapaneelissa Developer ja luo yrityksen API-avain, jolla on maksu-, paketti-, tuote- ja checkout-oikeudet. Syötä se yhdessä yritystunnuksesi kanssa: tunnus alkaa merkeillä
biz_ja näkyy hallintapaneelin osoiterivillä. Ota Sandbox käyttöön, niin voit testata maksuja ilman oikeaa rahaa.
Jos yhdistät molemmat, valitse, kumpaa maksuissa käytetään. Sovelluksesi koodi pysyy samana kummassakin tapauksessa.
2. Aloita maksu
// 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)Hinnat luetaan aina palvelimella tietueesta, joka on readonly-säännöllä suojatussa kokoelmassa (kentät name ja price). Tietueen sijaan voit antaa Stripen Price ID:n (price_…, vain Stripe) tai Whopin paketti-ID:n (plan_…, vain Whop, yksi maksua kohden).
Kävijä ohjataan palveluntarjoajasi turvalliselle maksusivulle ja palaa sen jälkeen samaan näkymään. Voit myös vain pyytää builder77:ää: ”lisää Osta-painike, joka veloittaa 15 $ tunnilta”.
3. Tarkista tulos
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Tilaukset
// 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 pageTilaukset toimivat kummankin palveluntarjoajan kanssa, ja ostajan on oltava kirjautunut. b77.payments.manage() avaa Stripen asiakasportaalin tai ostajan Whop-jäsenyyssivun. Jotta maksullinen sisältö pysyy lukittuna palvelimella, tallenna se kokoelmaan, jolla on sääntö members tai members-private.
Maksutietueet
Jokainen maksu tallennetaan sovelluksesi payments-kokoelmaan kenttinä status (pending, paid, expired), amount, currency, items ja metadata, ja näet ne Data-välilehdellä. Jokainen maksu kuluttaa 1 integraatiokrediitin.