For one-time payments, use submit_type to customize the button text.Ĭollect shipping address information by passing an array of allowed_countries that you want to ship to. If you specify Session.line_items, Checkout displays the name for each line item.Ĭheckout automatically customizes the button text depending on the items you’re selling. If you specify a price, Checkout displays the name of the product that belongs to the price. Client-only integration: The product.name for the price.product.name for prices specified in Session.line_items.You can specify a supported locale when creating a Checkout Session. No longer a parameter passed to Checkout.Checkout displays your business logo by default and falls back to your business icon alongside your business name. Product images Specify images for each line item with product.imagesĬheckout uses specific images for your business’s branding and for the products you’re selling.Business branding Upload your business logo or icon in the Dashboard.If you already know your customer’s email, specify it here so they do not need to enter it again. If you specify Session.line_items, Checkout displays the name for each line item. If you specify a price, Checkout displays an automatically computed description of how often payments occur. Client-only integration: The price’s scription.Client-only integration: The price’s currency.When a customer wants to close Checkout, they either close the browser tab or navigate to the cancelUrl. Set this parameter to required to always collect the billing address. Client-only integration: billingAddressCollectionĬheckout automatically collects the billing address when required for fraud-prevention or regulatory purposes.The total amount is the sum of the line items you pass to Checkout. Client-only integration: Automatically calculated as the sum of amounts over all prices.Automatically calculated as the sum of amounts over all line_items.To reuse existing customers, we recommend specifying the customer parameter when creating a Checkout Session. The current version of Checkout doesn’t support Remember Me. With the legacy version of Checkout, you’d display the dynamic amount and description and collect card information from your customer. The current version of the Checkout server integration reverses this flow-you create a Session on your server, pass its ID to your client, redirect your customer to Checkout, who then gets redirected back to your application upon success. You may have used the legacy version of Checkout to create a token or source on the client, and passed it to your server to create a charge. If you’re selling products where the amount or line items are determined dynamically (say, with a large product catalog or for donations), see accepting one-time payments. If you’re a SaaS provider with a monthly subscription plan.Īs you follow the relevant migration guide, you can also reference the conversion table for a mapping of specific parameters and configuration options between the two versions of Checkout. If you’re selling a few products with pre-determined prices. Simple product catalog with fixed pricing If you’re operating a business which doesn’t charge the customer until after services rendered. If you’re operating a marketplace connecting service providers with customers. If you’re a SaaS provider billing users and need support for advanced features. If you have a large product catalog or require support for dynamically generated line items (such as donations or taxes). Each guide recommends an integration path along with example code.
To migrate from the legacy version to the current version, follow the guide that most closely represents your business model. You can also use the client-only integration if you want to get started more quickly or if you have a simpler product catalog. The current version of Checkout provides more flexibility, with support for dynamic line items, Connect, re-using existing Customers, and advanced subscription features. It supports Apple Pay, Dynamic 3D Secure, and many other features. In contrast, the current version of Checkout is a smart payment page hosted by Stripe that creates payments or subscriptions. The legacy version of Checkout presented customers with a modal dialog that collected card information, and returned a token or a source to your website. If you want to embed a payment form within an existing page, consider using Stripe Elements.