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