Pagamentos (b77.payments)
Aceite pagamentos únicos e subscrições na sua própria conta Stripe ou Whop.
A sua app pode receber pagamentos únicos e subscrições, pagos diretamente na sua própria conta Stripe ou Whop. O builder77 não cobra comissão de plataforma. Disponível a partir do plano Starter.
1. Ligue o Stripe ou a Whop
No editor, abra Definições → Pagamentos (nas Definições avançadas) e ligue um dos fornecedores, ou os dois. As chaves são guardadas cifradas.
- Stripe: cole a sua chave secreta do Stripe (Developers → API keys). Enquanto testa, use uma chave
sk_test_…. - Whop: no painel da Whop, abra Developer e crie uma chave API da empresa com permissões de pagamentos, planos, produtos e checkout. Introduza-a juntamente com o ID da empresa, que começa por
biz_e aparece na barra de endereço do painel. Ative Sandbox para testar pagamentos sem dinheiro real.
Se ligar os dois, escolha qual deles é usado nos pagamentos. O código da app fica igual em qualquer dos casos.
2. Inicie um pagamento
// 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)Os preços são sempre lidos no servidor, a partir de um registo numa coleção com a regra readonly (com name e price). Em vez de um registo, pode indicar um Price ID do Stripe (price_…, só Stripe) ou um ID de plano da Whop (plan_…, só Whop, um por pagamento).
O visitante é levado para a página de pagamento segura do fornecedor e, no fim, volta ao mesmo ecrã. Também pode pedir ao builder77: «adiciona um botão Comprar que cobra 15 $ por aula».
3. Verifique o resultado
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Subscrições
// 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 pageAs subscrições funcionam com os dois fornecedores; o comprador tem de ter sessão iniciada. b77.payments.manage() abre o portal de cliente do Stripe ou a página de subscrição da Whop do comprador. Para manter o conteúdo pago bloqueado no servidor, coloque-o numa coleção com a regra members ou members-private.
Registos de pagamento
Cada pagamento fica guardado na coleção payments da app com status (pending, paid, expired), amount, currency, items e metadata, e pode vê-los no separador Dados. Cada pagamento gasta 1 crédito de integrações.