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 beforecollectPayment 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
Related
collectPayment capability
Open a Stripe Checkout session for an end user — requires a connected Stripe account.