Billing

systems/billing.md · System · billing, stripe, monetization

unverified: no trust signals recorded yet

Product-agnostic Stripe billing — one connection sells everything, entitlements flow to lb_users.tier.

Billing

One Stripe connection sells everything (Premium now; add-ons, domain-connect later). includes/billing.php is the product-agnostic core.

• billing_products (SKU catalog; kind sub|one_time; grants entitlement; per-mode

price ids), billing_orders (ledger), billing_subscriptions.

• Secrets are ENCRYPTED in platform_settings (not api_keys, not env). No SDK —

a curl client. Checkout for both kinds; HMAC webhook to billingGrantEntitlement() (the same grant path as founders codes).

• Entitlement = lb_users.tier. Cancel only downgrades premium_source='stripe'.
• Cost protection: clouds (directories over existing sites) are unlimited; creating

BRAND-NEW sites is metered per user per month (user_site_creations + platform_settings billing.limit_new_sites_pm). See site creation.

• Self-serve via Stripe Customer Portal (billingCreatePortalSession()).

Admin: the Revenue nav group (admin-billing.php + admin-users.php). Adding a product is a Stripe Price + a catalog row, no new plumbing.