Open a checkout
Open a Stripe Checkout session for one of the plans and answer the page to send the buyer to.
Payment is taken at Stripe and nowhere else: this API never receives card details. Access opens when Stripe confirms the payment, which is usually seconds after the buyer finishes, so read the billing object again rather than trusting their return.
A price this account may not take up is refused before any session is opened. That covers an account that already owns the product outright, and a subscriber asking for a plan that does not sit above the one they are on.
Body parameters
Sent as JSON. Anything not listed here is ignored.
The id of the price at Stripe, from offers in the billing object. Maximum 255 characters.
Which of the currencies the plan is quoted in to charge, three letters. Left out, Stripe charges in the currency of the price.
Returns
A checkout_session object carrying the URL. 422 when the price is not a plan this account may take up, and 503 when Stripe did not answer, in which case nothing was charged and nothing changed.
The checkout that was opened.
Always checkout_session.
Everything the record holds.
The page at Stripe to send the buyer to. It is short lived, it is the only place a card is ever entered, and opening it charges nothing on its own.
Rate limit
Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in X-RateLimit-Remaining.
Keys act as you, with exactly the access you have. Make one per integration so you can revoke it alone.