Betalingen (b77.payments)
Ontvang eenmalige betalingen en abonnementen via je eigen Stripe- of Whop-account.
Laat je app eenmalige betalingen en abonnementen ontvangen, rechtstreeks op je eigen Stripe- of Whop-account. builder77 rekent geen platformkosten. Beschikbaar vanaf Starter.
1. Koppel Stripe of Whop
Open in de builder Instellingen → Betalingen (in Geavanceerde instellingen) en koppel een van beide providers, of allebei. Sleutels worden versleuteld opgeslagen.
- Stripe: plak je geheime Stripe-sleutel (Developers → API keys). Gebruik tijdens het testen een
sk_test_…-sleutel. - Whop: open in het Whop-dashboard Developer en maak een bedrijfs-API-sleutel met rechten voor betalingen, plannen, producten en checkout. Vul die in samen met je bedrijfs-ID: die begint met
biz_en staat in de adresbalk van het dashboard. Zet Sandbox aan om betalingen te testen zonder echt geld.
Heb je ze allebei gekoppeld, kies dan welke je betalingen gebruiken. De code van je app blijft in beide gevallen hetzelfde.
2. Start een betaling
// 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)Prijzen worden altijd op de server gelezen, uit een record in een collectie met de regel readonly (met name en price). In plaats van een record kun je ook een Stripe Price ID (price_…, alleen Stripe) of een Whop-plan-ID (plan_…, alleen Whop, één per betaling) meegeven.
De bezoeker gaat naar de beveiligde betaalpagina van je provider en komt daarna terug op hetzelfde scherm. Of vraag het gewoon aan builder77: „voeg een Koop-knop toe die $15 per les rekent”.
3. Controleer het resultaat
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Abonnementen
// 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 pageAbonnementen werken met beide providers; de koper moet ingelogd zijn. b77.payments.manage() opent het klantenportaal van Stripe of de Whop-lidmaatschapspagina van de koper. Wil je betaalde content op de server afgeschermd houden, zet die dan in een collectie met de regel members of members-private.
Betalingsrecords
Elke betaling wordt opgeslagen in de collectie payments van je app met status (pending, paid, expired), amount, currency, items en metadata, en je ziet ze in het tabblad Data. Elke betaling kost 1 integratiecredit.