Backend e SDK

Pagamenti (b77.payments)

Accetta pagamenti una tantum e abbonamenti con il tuo account Stripe o Whop.

La tua app può accettare pagamenti una tantum e abbonamenti, accreditati direttamente sul tuo account Stripe o Whop. builder77 non trattiene commissioni. Disponibile dal piano Starter in su.

1. Collega Stripe o Whop

Nell'editor apri Impostazioni → Pagamenti (in Impostazioni avanzate) e collega uno dei due provider o entrambi. Le chiavi sono salvate cifrate.

  • Stripe: incolla la tua chiave segreta Stripe (Developers → API keys). Durante i test usa una chiave sk_test_….
  • Whop: nella dashboard di Whop apri Developer e crea una chiave API aziendale con i permessi per pagamenti, piani, prodotti e checkout. Inseriscila insieme al tuo ID azienda: inizia con biz_ ed è nella barra degli indirizzi della dashboard. Attiva Sandbox per provare i pagamenti senza soldi veri.

Se li colleghi entrambi, scegli quale usare per i pagamenti. Il codice della tua app resta lo stesso in ogni caso.

2. Avvia un pagamento

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

I prezzi vengono sempre letti sul server, da un record di una collezione con la regola readonly (con name e price). Al posto di un record puoi passare un Price ID di Stripe (price_…, solo Stripe) o un ID piano di Whop (plan_…, solo Whop, uno per pagamento).

Il visitatore viene portato sulla pagina di pagamento sicura del tuo provider e poi torna alla stessa schermata. Oppure, più semplicemente, chiedi a builder77: “aggiungi un pulsante Acquista che addebita 15 $ a lezione”.

3. Controlla il risultato

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

Abbonamenti

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

Gli abbonamenti funzionano con entrambi i provider; l'acquirente deve aver effettuato l'accesso. b77.payments.manage() apre il portale clienti di Stripe o la pagina dell'abbonamento Whop dell'acquirente. Per tenere i contenuti a pagamento bloccati sul server, mettili in una collezione con la regola members o members-private.

Record dei pagamenti

Ogni pagamento viene salvato nella collezione payments della tua app con status (pending, paid, expired), amount, currency, items e metadata, e lo trovi nella scheda Dati. Ogni pagamento usa 1 credito di integrazione.