77builder77
Бекенд і SDK

Платежі (b77.payments)

Приймай разові платежі й підписки на свій обліковий запис Stripe або Whop.

Дозволь додатку приймати разові платежі й підписки. Гроші надходять просто на твій обліковий запис Stripe або Whop, а builder77 не бере комісії платформи. Доступно з тарифу Starter.

1. Підключи Stripe або Whop

У редакторі відкрий Налаштування → Платежі (у Розширених налаштуваннях) і підключи Stripe, Whop або обидва. Ключі зберігаються в зашифрованому вигляді.

  • Stripe: встав секретний ключ Stripe (Developers → API keys). Для тестів використовуй ключ sk_test_….
  • Whop: у панелі Whop відкрий Developer і створи API-ключ компанії з дозволами на платежі, плани, продукти й checkout. Введи його разом з ID своєї компанії: він починається з biz_, і його видно в адресному рядку панелі. Увімкни Sandbox, щоб тестувати платежі без справжніх грошей.

Якщо підключено обидва, обери, через який проходитимуть оплати. Код додатка в обох випадках однаковий.

2. Запусти оплату

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

Ціни завжди зчитуються на сервері із запису в колекції з правилом readonly (з полями name і price). Замість запису можна передати Stripe Price ID (price_…, лише Stripe) або ID плану Whop (plan_…, лише Whop, один на оплату).

Відвідувач переходить на захищену сторінку оплати твого провайдера, а потім повертається на той самий екран. Або просто попроси builder77: «додай кнопку Купити, яка списує 15 $ за заняття».

3. Перевір результат

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

Підписки

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

Підписки працюють з обома провайдерами; покупець має бути авторизований. b77.payments.manage() відкриває клієнтський портал Stripe або сторінку підписки покупця у Whop. Щоб платний вміст залишався закритим на сервері, зберігай його в колекції з правилом members або members-private.

Записи про платежі

Кожна оплата зберігається в колекції payments твого додатка з полями status (pending, paid, expired), amount, currency, items і metadata, і її видно на вкладці Дані. Кожна оплата витрачає 1 кредит інтеграцій.