Customize Checkout

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

Apply 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 Checkout page’s background color, button color, font, and shapes

See the font compatibility page for more information about custom fonts.

You can also customize the domain name that Checkout uses.

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

From Checkout Settings, add support contact information to your sessions by enabling Contact information. Similarly, add links to your Terms of service and Privacy policy to your sessions by enabling Legal policies. If you require customers to implicitly consent to your legal policies when they complete their checkout, select the Display agreement to legal terms checkbox.

You must add your support contact information and legal policy links in your Public Detail Settings.

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.

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.

Customize 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_Hrs6SAopgFPF0bZXSN3f6ELN
: \
  -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 €.

Autofill payment details with Link

Link lets your customers securely save their payment information and re-use them on your site and across thousands of businesses using 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.

How Link 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, 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 so that they can pay without having to type in their details.