Backend ja SDK

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 page

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