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

For information on custom fonts, refer to font compatibility.

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.

Change your brand name

You can change a Checkout page’s name by modifying the Public business name field in public settings.

You can also customize the domain name that Checkout uses.

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.

Collect a terms of service agreement

Businesses often require their customers to agree to their terms of service before they can pay. This might depend on the type of product or subscription. Checkout helps you collect the necessary agreement by requiring a customer to accept your terms before paying.

Collect terms of service agreement

You can collect a terms of service agreement with Stripe Checkout when you create a Session:

Command Line

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_test_rfaBmNUu1lWB7VZ0MMSIsYjH
: \
  -d "payment_method_types[0]"=card \
  -d "line_items[0][price]"="{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=2 \
  -d mode=payment \
  -d success_url="https://example.com/success" \
  -d cancel_url="https://example.com/cancel" \
  -d "consent_collection[terms_of_service]"="required"

When consent_collection.terms_of_service='required', Checkout dynamically displays a checkbox for collecting the customer’s terms of service agreement. If consent_collection.terms_of_service='none', Checkout won’t display the checkbox and won’t require customers to accept the terms of service. Before requiring agreement to your terms, set your terms of service URL in your business’ Public details. Setting a privacy policy URL is optional—Checkout also links to your privacy policy when a URL to your Privacy policy is set in your Public details.

After a customer completes checkout, you can verify that the customer accepted your terms of service by looking at the Session object in the checkout.session.completed webhook, or by retrieving the Session using the API. When the terms are accepted, the Session’s consent.terms_of_service field is set to "accepted".

Note that Google Pay and Apple Pay aren’t supported payment methods for Sessions that require terms of service agreement—customers won’t see an option to complete their payment with Google Pay or Apple Pay.

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:

Command Line

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_test_rfaBmNUu1lWB7VZ0MMSIsYjH
: \
  -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.