Pagos (b77.payments)
Acepta pagos únicos y suscripciones con tu propia cuenta de Stripe o Whop.
Tu app puede cobrar pagos únicos y suscripciones, que se ingresan directamente en tu propia cuenta de Stripe o Whop. builder77 no cobra comisión de plataforma. Disponible desde el plan Starter.
1. Conecta Stripe o Whop
En el editor, abre Ajustes → Pagos (dentro de Ajustes avanzados) y conecta uno de los dos proveedores o ambos. Las claves se guardan cifradas.
- Stripe: pega tu clave secreta de Stripe (Developers → API keys). Usa una clave
sk_test_…mientras pruebas. - Whop: en el panel de Whop abre Developer y crea una clave API de empresa con permisos de pagos, planes, productos y checkout. Introdúcela junto con tu ID de empresa, que empieza por
biz_y aparece en la barra de direcciones del panel. Activa Sandbox para probar pagos sin dinero real.
Si conectas los dos, elige cuál usan tus pagos. El código de tu app es el mismo en ambos casos.
2. Inicia un pago
// 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)Los precios siempre se leen en el servidor, a partir de un registro de una colección con la regla readonly (con name y price). En lugar de un registro puedes pasar un Price ID de Stripe (price_…, solo Stripe) o un ID de plan de Whop (plan_…, solo Whop, uno por pago).
El visitante va a la página de pago segura de tu proveedor y después vuelve a la misma pantalla. O simplemente pídeselo a builder77: «añade un botón Comprar que cobre 15 $ por clase».
3. Comprueba el resultado
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Suscripciones
// 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 pageLas suscripciones funcionan con ambos proveedores; el comprador debe haber iniciado sesión. b77.payments.manage() abre el portal de clientes de Stripe o la página de membresía de Whop del comprador. Para que el contenido de pago quede bloqueado en el servidor, guárdalo en una colección con la regla members o members-private.
Registros de pago
Cada pago se guarda en la colección payments de tu app con status (pending, paid, expired), amount, currency, items y metadata, y puedes verlo en la pestaña Datos. Cada pago usa 1 crédito de integración.