Backend e SDK

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 page

As 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.