SetupBilling
Request body
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).
coupon_code is an optional coupon to apply when computing the in-session authorization amount. Only meaningful when amount_cents is set.
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.
organization_id is the ID of the organization to update
Response
Success
customer_session_client_secret is the client secret for the Stripe CustomerSession
setup_intent_client_secret is the client secret for the Stripe SetupIntent