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

Use Studio to create the products and prices your app will sell. Your app can then read that 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.