Backend i SDK

Płatności (b77.payments)

Przyjmuj płatności jednorazowe i subskrypcje na własne konto Stripe lub Whop.

Aplikacja może przyjmować płatności jednorazowe i subskrypcje, które trafiają prosto na Twoje konto Stripe lub Whop. builder77 nie pobiera prowizji. Dostępne od planu Starter.

1. Połącz Stripe lub Whop

W kreatorze otwórz Ustawienia → Płatności (w Ustawieniach zaawansowanych) i połącz jednego dostawcę albo obu. Klucze są przechowywane w postaci zaszyfrowanej.

  • Stripe: wklej tajny klucz Stripe (Developers → API keys). Do testów używaj klucza sk_test_….
  • Whop: w panelu Whop otwórz Developer i utwórz firmowy klucz API z uprawnieniami do płatności, planów, produktów i checkoutu. Wpisz go razem z ID firmy, które zaczyna się od biz_ i jest widoczne w pasku adresu panelu. Włącz Sandbox, żeby testować płatności bez prawdziwych pieniędzy.

Jeśli połączysz obu, wybierz, z którego mają korzystać płatności. Kod aplikacji w obu przypadkach pozostaje taki sam.

2. Rozpocznij płatność

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

Ceny są zawsze odczytywane na serwerze, z rekordu w kolekcji z regułą readonly (z polami name i price). Zamiast rekordu możesz podać Stripe Price ID (price_…, tylko Stripe) albo ID planu Whop (plan_…, tylko Whop, jeden na płatność).

Odwiedzający trafia na bezpieczną stronę płatności Twojego dostawcy, a potem wraca na ten sam ekran. Możesz też po prostu poprosić builder77: „dodaj przycisk Kup, który pobiera 15 $ za zajęcia”.

3. Sprawdź wynik

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

Subskrypcje

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

Subskrypcje działają z oboma dostawcami; kupujący musi być zalogowany. b77.payments.manage() otwiera portal klienta Stripe albo stronę członkostwa kupującego w Whop. Żeby płatne treści pozostały zablokowane na serwerze, umieść je w kolekcji z regułą members lub members-private.

Rekordy płatności

Każda płatność jest zapisywana w kolekcji payments aplikacji z polami status (pending, paid, expired), amount, currency, items i metadata. Zobaczysz ją w zakładce Dane. Każda płatność zużywa 1 kredyt integracji.