Backend och SDK

Betalningar (b77.payments)

Ta emot engångsbetalningar och prenumerationer med ditt eget Stripe- eller Whop-konto.

Låt din app ta emot engångsbetalningar och prenumerationer som går direkt till ditt eget Stripe- eller Whop-konto. builder77 tar ingen plattformsavgift. Finns från Starter och uppåt.

1. Anslut Stripe eller Whop

Öppna Inställningar → Betalningar (i Avancerade inställningar) i byggverktyget och anslut en av leverantörerna eller båda. Nycklarna lagras krypterade.

  • Stripe: klistra in din hemliga Stripe-nyckel (Developers → API keys). Använd en sk_test_…-nyckel medan du testar.
  • Whop: öppna Developer i Whops instrumentpanel och skapa en API-nyckel för företaget med behörighet för betalningar, planer, produkter och checkout. Ange den tillsammans med ditt företags-ID, som börjar med biz_ och står i instrumentpanelens adressfält. Slå på Sandbox för att testa betalningar utan riktiga pengar.

Har du anslutit båda väljer du vilken som används för betalningarna. Appens kod är densamma i båda fallen.

2. Starta en betalning

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

Priserna läses alltid på servern, från en post i en samling med regeln readonly (med name och price). I stället för en post kan du ange ett Stripe Price ID (price_…, bara Stripe) eller ett Whop-plan-ID (plan_…, bara Whop, ett per betalning).

Besökaren skickas till leverantörens säkra betalsida och kommer sedan tillbaka till samma skärm. Eller be bara builder77: ”lägg till en Köp-knapp som tar 15 $ per pass”.

3. Kontrollera resultatet

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

Prenumerationer

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

Prenumerationer fungerar med båda leverantörerna; köparen måste vara inloggad. b77.payments.manage() öppnar Stripes kundportal eller köparens medlemssida på Whop. Lägg betalt innehåll i en samling med regeln members eller members-private, så förblir det låst på servern.

Betalningsposter

Varje betalning sparas i appens samling payments med status (pending, paid, expired), amount, currency, items och metadata, och du ser den under fliken Data. Varje betalning kostar 1 integrationskredit.