Backend & SDK

Zahlungen (b77.payments)

Nimm Einmalzahlungen und Abos mit deinem eigenen Stripe- oder Whop-Konto an.

Deine App kann Einmalzahlungen und Abos annehmen, und das Geld geht direkt auf dein eigenes Stripe- oder Whop-Konto. builder77 nimmt keine Plattformgebühr. Verfügbar ab Starter.

1. Stripe oder Whop verbinden

Öffne im Builder Einstellungen → Zahlungen (in den Erweiterten Einstellungen) und verbinde einen der beiden Anbieter oder beide. Die Schlüssel werden verschlüsselt gespeichert.

  • Stripe: Füge deinen geheimen Stripe-Schlüssel ein (Developers → API keys). Nutze beim Testen einen sk_test_…-Schlüssel.
  • Whop: Öffne im Whop-Dashboard den Bereich Developer und erstelle einen Unternehmens-API-Schlüssel mit den Berechtigungen für Zahlungen, Pläne, Produkte und Checkout. Gib ihn zusammen mit deiner Unternehmens-ID ein. Sie beginnt mit biz_ und steht in der Adresszeile des Dashboards. Schalte Sandbox ein, um Zahlungen ohne echtes Geld zu testen.

Sind beide verbunden, wählst du, welcher Anbieter für deine Checkouts verwendet wird. Der Code deiner App bleibt in beiden Fällen gleich.

2. Checkout starten

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

Preise werden immer auf dem Server gelesen, aus einem Datensatz in einer Collection mit der Regel readonly (mit name und price). Statt eines Datensatzes kannst du auch eine Stripe-Price-ID (price_…, nur Stripe) oder eine Whop-Plan-ID (plan_…, nur Whop, eine pro Checkout) übergeben.

Der Besucher wird auf die sichere Checkout-Seite deines Anbieters weitergeleitet und kommt danach zum selben Screen zurück. Du kannst auch einfach builder77 fragen: „füge einen Kaufen-Button hinzu, der 15 $ pro Kurs berechnet“.

3. Ergebnis prüfen

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

Abos

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

Abos funktionieren mit beiden Anbietern; der Käufer muss angemeldet sein. b77.payments.manage() öffnet das Stripe-Kundenportal oder die Whop-Mitgliedschaftsseite des Käufers. Damit bezahlte Inhalte auf dem Server gesperrt bleiben, lege sie in eine Collection mit der Regel members oder members-private.

Zahlungsdatensätze

Jeder Checkout wird in der Collection payments deiner App gespeichert, mit status (pending, paid, expired), amount, currency, items und metadata, und du siehst ihn im Tab Daten. Jeder Checkout kostet 1 Integrations-Credit.