v18

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014211,6201.8 MB
gitpod.v1.BillingService

SetupBilling

post/gitpod.v1.BillingService/SetupBilling

Request body

amountCentsstring nullable

amount_cents is the intended first-month subscription amount in cents. When set, the server authorizes this amount in-session (a manual-capture PaymentIntent hold) instead of a zero-amount SetupIntent, so the charge can be captured asynchronously after the subscription is granted. When unset, the server falls back to a SetupIntent (the existing card-on-file flow).

couponCodestring nullable

coupon_code is an optional coupon to apply when computing the in-session authorization amount. Only meaningful when amount_cents is set.

intentIdstring nullable

intent_id, when provided, identifies an existing PaymentIntent to update in place with the new amount_cents instead of creating a new one. This lets the client adjust the authorized amount as the user changes their selection without churning a new PaymentIntent (and its hold) on every change. Only meaningful when amount_cents is set; ignored on the SetupIntent fallback.

organizationIdstring uuid required

organization_id is the ID of the organization to update

Response

Success

customerSessionClientSecretstring required

customer_session_client_secret is the client secret for the Stripe CustomerSession

setupIntentClientSecretstring required

setup_intent_client_secret is the client secret for the Stripe SetupIntent