Skip to main content
Monetization is the inverse of billing. Where Billing tracks what gavAI charges you, Monetization is how you charge your own customers. It manages Stripe Connect onboarding for your workspace and exposes the connected account list that powers the collectPayment and listPlans capabilities at runtime. By the end of this page you will know the onboarding flow, how to read the connection state, and when collectPayment becomes usable.
This resource controls your workspace charging your end users. For what gavAI charges you, see Billing.

Onboarding walkthrough

Stripe Connect onboarding must complete before collectPayment can process payments. The flow is asynchronous: you fetch a redirect URL, send the workspace owner through Stripe’s hosted flow, then poll until state is connected.

Endpoints

Current Stripe Connect status for the workspace. Begin or refresh Stripe Connect onboarding. List connected Stripe accounts.

Status shape

stripe_account_id is null before onboarding starts. capabilities_enabled lists the platform capabilities the current Connect state unlocks.

Onboarding URL shape

The onboarding URL is a Stripe-generated link with a short expiry. Do not cache it — call POST each time you need a fresh link.

Common errors

collectPayment capability

Open a Stripe Checkout session for an end user — requires a connected Stripe account.