Configure checkout experience

After you create an embedded checkout, you can customize what buyers see and what information FastSpring collects during checkout.

In the FastSpring app, go to Checkouts > Embedded Checkouts, select Settings on the checkout you want to edit, then click the Checkout tab to view configuration options.

The sections below describe each area of checkout configuration. Select a section or use the TOC on the right to jump ahead.

Choose your payment method layout

Controls how payment methods are displayed during checkout. You can switch between layout options at any time in Settings > Checkout.

Layout	Description
Inline view	Displays payment methods horizontally and supports all checkout fields, including company, address, and phone number.
Stacked view	Displays payment methods vertically in an accordion-style layout. Optimized for mobile checkouts that collect only basic buyer information.

For detailed examples of each layout, see Create an embedded checkout.

Checkout experience

The checkout experience settings define how buyers interact with your embedded checkout. You can control localization, subscription visibility, accessibility, and general buyer-facing options.

Country and language selector

Determines whether buyers can view or change their country and language at checkout.

Option	Description
Enable	Buyers can adjust both the country and language displayed in checkout.
Enable, but lock	FastSpring automatically localizes checkout based on the buyer's browser and location, but buyers cannot change the selection manually.
Disable	Hides the selector from buyers.

This setting affects the checkout interface only, not your entire website.

Subscription terms display

Controls how subscription details appear for buyers.

Option	Description
Display subscription terms behind "View details" link	Buyers can expand a link to review subscription terms before purchase.
Expose subscription terms directly on checkout	Displays subscription terms by default without requiring expansion.

Tax exemption

Adds a link that allows buyers to enter a tax exemption ID at checkout. When enabled, FastSpring removes applicable taxes after the ID is validated.
Click the checkbox to enable this setting.

Open footer links in overlays

Opens the Privacy Policy and Terms of Sale links in overlays instead of a new browser tab. Recommended for in-app or embedded checkouts to keep buyers in the same viewport.
Click the checkbox to enable this setting.

Provide a visual cue of focus point on checkout entry

Displays a visible border around the most interactive element when checkout loads. This helps buyers using assistive technology recognize the active focus area.
Click the checkbox to enable this setting.

Accessibility best practices

Accessible configuration ensures your checkout is usable and readable for all buyers.
Follow these guidelines when adjusting fields, colors, or layout behavior.

• Ensure all visible text meets a 4.5:1 contrast ratio for readability.
• Keep focus indicators visible when buyers navigate with a keyboard or assistive device.
• Avoid hiding essential information behind hover-only interactions.
• Confirm that overlay dialogs (such as Privacy Policy) remain readable and scrollable on mobile.

Promotion

Promotion settings control how buyers can apply discount codes during checkout.

Setting	Description
'Promotional Code' field	Allows customers to enter a coupon code directly at checkout to receive a discount. If disabled, customers will not see the promotional code field, but you can still pass a promotional code through the API. Click the checkbox to enable this setting.
Automatically expand "Promotional Code"	Specifies whether the promotional code field appears expanded or collapsed by default. Yes: The field appears open by default. No: Buyers click a link to expand the field manually.

Customer information

Customer information settings control how buyers can subscribe to updates and how their payment details are handled for recurring subscriptions.

Setting	Description	Dropdown options
Display newsletter subscription checkbox	Adds a checkbox labeled “Get free updates about our products and offerings” below the email field. When selected, FastSpring sends mailing list webhooks so you can add the buyer to your marketing list. Click the checkbox to enable this setting.	Yes, checked: Displays the checkbox, selected by default. Yes, unchecked: Displays the checkbox, not selected by default. No: Hides the checkbox from checkout.
Save payment method for auto subscription renewals and future purchases	Controls whether FastSpring saves or reuses payment details for recurring subscriptions and future one-time product purchases. For one-time product purchases, buyers can always opt out of saving their payment method.	Do not allow subscription customers to opt out from saving payment details: FastSpring saves payment details and automatically processes future renewals. Allow, opt-out: Payment details are saved by default, but buyers can clear the option during checkout. Allow, opt-in: Payment details are not saved by default, but buyers can choose to save them during checkout.

Completion page

Completion page settings define what buyers see immediately after completing their purchase. You can choose to display purchased products, license information, or both.

Setting	Description
Display products on completion page	Shows purchased products on the completion page so buyers can review their order summary. Click the checkbox to enable this setting.
Display licenses on completion page	Displays license details for the purchased products on the completion page. Click the checkbox to enable this setting.

Caching

Caching improves performance by temporarily storing checkout data in the buyer's browser. This reduces load times when a buyer reopens the checkout, but it can also delay the display of updated catalog prices.

Setting	Description
Allow browser caching	Stores checkout data locally for up to 10 minutes to reduce server calls and improve speed. Sellers who frequently update catalog prices should avoid enabling this setting, as cached data may delay price updates. Click the checkbox to enable this setting.