Customizing Checkout

Learn about the different ways you can customize your Stripe Checkout integration.

Branding

You can customize the look and feel of Checkout in the Stripe Dashboard. Go to Branding Settings where you can:

Upload a logo or icon
Customize the background and button color of the Checkout page

Branding with Connect: For platforms performing direct charges, and destination charges with on_behalf_of, Checkout uses the brand settings of the connected account. Platforms can configure the brand settings of connected Express and Custom accounts using the Accounts API.

Policies and contact information

You can display your return, refund, legal policies, and support contact information to your customers on Checkout. Go to Checkout Settings to configure the information you want to display, including:

Details about your return and refund policies
Your support phone number, email, and website
Links to your terms of service and privacy policy

Presenting this information can increase buyer confidence and minimize cart abandonment.

Configure support and legal policies

Add support contact information to your sessions by enabling Contact information. Similarly, add your Terms of service and Privacy policy to your sessions by selecting Legal policies. To display links to your support information and legal policies, you must add your support contact information and legal policy links in your Account Settings. If you require customers to implicitly consent to your legal policies when they complete their checkout, select the checkbox that reads “display agreement to legal terms.”

The following previews show how Checkout displays a dialog with the support contact information, links to the store legal policies, and information about the payment terms.

Preview of contact information on Checkout.

Preview of legal policies on Checkout.

Configure return and refund policies

Display your return, refund, or exchange policies, by enabling Return and Refund policies. Although businesses that sell physical goods use return policies, businesses that sell digital goods or customized physical goods typically use refund policies. Because they’re not mutually exclusive, you can select both options if your business sells both categories of goods. You can edit your return and refund details, including:

Whether you accept returns, refunds, or exchanges
Whether returns, refunds, or exchanges are free or if they’re subject to a fee
How many days after a purchase you’ll accept returns, refunds, or exchanges
How customers can return items shipped to them
Whether you accept in-store returns
A link to the full return and refund policy
A custom message

If you accept free returns, refunds, or exchanges, the policy is highlighted for customers.

The following previews show how Checkout displays a return policy. In this example, it’s for purchases that can be returned by shipping them or in-store for a full refund (or exchange) for up to 60 days. You can display similar information for refunds.

Preview of return policies on Checkout.

Preview of a policy highlight on Checkout.

Customizing the Submit button

You can configure the copy displayed on the Checkout submit button for one-time purchases to better align Checkout with your business model.

Define a submit_type on your session:

Terminal

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d submit_type=donate \
  -d "payment_method_types[]"=card \
  -d "line_items[][price]"="{{PRICE_ID}}" \
  -d "line_items[][quantity]"=1 \
  -d mode=payment \
  -d success_url="https://example.com/success" \
  -d cancel_url="https://example.com/cancel"

In this example (for a 5 USD donation), your customized Checkout submit button would read Donate $5.00. See the API reference for a complete list of submit_type options.

Localization and supported languages

By default, Checkout detects the locale of the customer’s browser and displays a translated version of the page in their language, if it is supported. You can also provide a specific locale for Checkout to use instead by providing the locale argument when creating a Checkout Session using the client-only or client and server integration.

Checkout also uses the locale to format numbers and currencies. For example, when selling a product whose price is set in EUR with the locale set to auto, a browser configured to use English (en) would see €25.00 while one configured for German (de) would see 25,00 €.

1-click payments using Link with Stripe

Link with Stripe lets your customers securely save their payment information and pay with 1 click on your site and across thousands of businesses using Checkout.

Preview of Link on Checkout.

Checkout supports this feature with no additional fees, and the same pricing applies as for other card payments. You can turn it off in the Checkout settings of the Dashboard if you don’t want to offer it.

Checkout sessions collecting shipping addresses are not yet supported.

How Link with Stripe works

Your customer can select save information to pay faster next time and enter their phone number to securely store their payment details with Stripe. For future purchases on your site and others using Link with Stripe, your customer will receive a 6 digit code by SMS to verify their identity and pre-fill all saved payment details. If your customer uses the same device and is already verified, Stripe will automatically pre-fill their information to offer a 1-click payment experience.