Customize checkout behavior

Customize the Submit button

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

Define a submit_type on your session. 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.

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

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 Stripe supports it. You can override the browser locale for Checkout by passing the locale parameter when you create a Checkout Session.

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 display €25.00 while one configured for German (de) would display 25,00 €.

Autofill payment details with Link

You can automatically use Link (Stripe’s one-click checkout) in your prebuilt Checkout page. To learn more, see Link with Checkout.