Setup

Billing setup happens in Creator Studio before you write app code.

1. Connect Stripe

In Studio:

1. Open Settings.
2. Choose Test or Live.
3. Click Connect Stripe.
4. Complete Stripe-hosted onboarding.

Buildspace creates a Stripe Accounts v2 merchant connected account, stores the connected account id, and sends creators to the full Stripe Dashboard for ongoing account management. Your app never receives Stripe secret keys.

2. Enable billing for the app environment

Open the app's Billing tab and enable billing for the environment you want to charge against.

• Development environments map to Stripe test mode.
• Production environments map to Stripe live mode.

Connecting Stripe alone is not enough. Billing must be enabled per app environment before your SDK calls can create Checkout or portal sessions.

3. Create products and prices

Create the products and prices your app will sell in Studio (the Billing tab), or from the CLI so an AI agent can do it:

buildspace app billing products create --name "Pro" --amount 29 --interval year --lookup-key pro-yearly
buildspace app billing products --json        # verify what exists

See App Management for updating and removing items. Your app can then read the catalog through the SDK:

const { products } = await bs.billing.listProducts();
const { prices } = await bs.billing.listPrices();

listProducts() is useful for rendering plan names and descriptions. listPrices() is usually the source of truth for upgrade buttons and checkout routing.