Paiements (b77.payments)
Acceptez des paiements ponctuels et des abonnements avec votre propre compte Stripe ou Whop.
Permettez à votre application d'encaisser des paiements ponctuels et des abonnements, versés directement sur votre propre compte Stripe ou Whop. builder77 ne prélève aucune commission. Disponible à partir du forfait Starter.
1. Connecter Stripe ou Whop
Dans l'outil de création, ouvrez Réglages → Paiements (dans Réglages avancés) et connectez l'un des deux fournisseurs, ou les deux. Les clés sont stockées chiffrées.
- Stripe : collez votre clé secrète Stripe (Developers → API keys). Utilisez une clé
sk_test_…pendant vos tests. - Whop : dans le tableau de bord Whop, ouvrez Developer et créez une clé API d'entreprise avec les autorisations paiements, plans, produits et checkout. Saisissez-la avec votre ID d'entreprise : il commence par
biz_et figure dans la barre d'adresse du tableau de bord. Activez Sandbox pour tester des paiements sans argent réel.
Si les deux sont connectés, choisissez celui qu'utilisent vos paiements. Le code de votre application reste le même dans les deux cas.
2. Lancer un paiement
// 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)Les prix sont toujours lus sur le serveur, à partir d'un enregistrement d'une collection avec la règle readonly (avec name et price). À la place d'un enregistrement, vous pouvez passer un Price ID Stripe (price_…, Stripe uniquement) ou un ID de plan Whop (plan_…, Whop uniquement, un par paiement).
Le visiteur est redirigé vers la page de paiement sécurisée de votre fournisseur, puis revient sur le même écran. Vous pouvez aussi le demander à builder77 : « ajoute un bouton Acheter qui facture 15 $ par cours ».
3. Vérifier le résultat
const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');Abonnements
// 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 pageLes abonnements fonctionnent avec les deux fournisseurs ; l'acheteur doit être connecté. b77.payments.manage() ouvre le portail client Stripe ou la page d'abonnement Whop de l'acheteur. Pour que le contenu payant reste verrouillé côté serveur, placez-le dans une collection avec la règle members ou members-private.
Enregistrements de paiement
Chaque paiement est enregistré dans la collection payments de votre application avec status (pending, paid, expired), amount, currency, items et metadata ; vous le retrouvez dans l'onglet Données. Chaque paiement utilise 1 crédit d'intégration.