Pagaments (b77.payments)
Accepta pagaments únics i subscripcions amb el teu propi compte de Stripe o Whop.
Deixa que la teva app cobri pagaments únics i subscripcions, que van directament al teu compte de Stripe o de Whop. builder77 no cobra cap comissió de plataforma. Disponible a partir del pla Starter.
1. Connecta Stripe o Whop
A l'editor, obre Configuració → Pagaments (dins de Configuració avançada) i connecta un proveïdor o tots dos. Les claus es desen xifrades.
- Stripe: enganxa la clau secreta de Stripe (Developers → API keys). Mentre fas proves, fes servir una clau
sk_test_…. - Whop: al tauler de Whop, obre Developer i crea una clau API d'empresa amb permisos de pagaments, plans, productes i checkout. Introdueix-la juntament amb l'ID de la teva empresa, que comença per
biz_i apareix a la barra d'adreces del tauler. Activa Sandbox per provar pagaments sense diners reals.
Si en tens tots dos connectats, tria quin fan servir els pagaments. El codi de l'app és el mateix en tots dos casos.
2. Inicia un pagament
// 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)Els preus sempre es llegeixen al servidor, a partir d'un registre d'una col·lecció amb la regla readonly (amb name i price). En lloc d'un registre pots passar un Price ID de Stripe (price_…, només Stripe) o un ID de pla de Whop (plan_…, només Whop, un per pagament).
El visitant passa a la pàgina de pagament segura del teu proveïdor i després torna a la mateixa pantalla. O simplement demana-ho a builder77: «afegeix un botó Compra que cobri 15 $ per classe».
3. Comprova el resultat
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Subscripcions
// 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 pageLes subscripcions funcionen amb tots dos proveïdors; el comprador ha d'haver iniciat sessió. b77.payments.manage() obre el portal de clients de Stripe o la pàgina de subscripció de Whop del comprador. Perquè el contingut de pagament quedi bloquejat al servidor, desa'l en una col·lecció amb la regla members o members-private.
Registres de pagament
Cada pagament es desa a la col·lecció payments de la teva app amb status (pending, paid, expired), amount, currency, items i metadata, i el pots veure a la pestanya Dades. Cada pagament gasta 1 crèdit d'integració.