Backend og SDK

Betalinger (b77.payments)

Ta imot engangsbetalinger og abonnementer med din egen Stripe- eller Whop-konto.

La appen din ta imot engangsbetalinger og abonnementer, betalt rett inn på din egen Stripe- eller Whop-konto. builder77 tar ingen plattformavgift. Tilgjengelig fra Starter og oppover.

1. Koble til Stripe eller Whop

Åpne Innstillinger → Betalinger (i Avanserte innstillinger) i byggeverktøyet og koble til én av leverandørene eller begge. Nøklene lagres kryptert.

  • Stripe: lim inn den hemmelige Stripe-nøkkelen din (Developers → API keys). Bruk en sk_test_…-nøkkel mens du tester.
  • Whop: åpne Developer i Whop-dashbordet og lag en API-nøkkel for bedriften med tilgang til betalinger, planer, produkter og checkout. Legg den inn sammen med bedrifts-ID-en din, som starter med biz_ og står i adressefeltet i dashbordet. Slå på Sandbox for å teste betalinger uten ekte penger.

Har du koblet til begge, velger du hvilken betalingene skal gå gjennom. Koden i appen er den samme uansett.

2. Start en 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)

Prisene leses alltid på serveren, fra en post i en samling med regelen readonly (med name og price). I stedet for en post kan du oppgi en Stripe Price ID (price_…, bare Stripe) eller en Whop-plan-ID (plan_…, bare Whop, én per betaling).

Den besøkende sendes til leverandørens sikre betalingsside og kommer tilbake til samme skjerm etterpå. Du kan også bare be builder77: «legg til en Kjøp-knapp som tar 15 dollar per time».

3. Sjekk resultatet

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

Abonnementer

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

Abonnementer fungerer med begge leverandørene; kjøperen må være logget inn. b77.payments.manage() åpner Stripes kundeportal eller kjøperens medlemskapsside hos Whop. Legg betalt innhold i en samling med regelen members eller members-private, så holdes det låst på serveren.

Betalingsposter

Hver betaling lagres i appens payments-samling med status (pending, paid, expired), amount, currency, items og metadata, og du ser den i Data-fanen. Hver betaling bruker 1 integrasjonskreditt.