Платежі (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 кредит інтеграцій.