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 кредит за интеграции.