Customize checkout for Payment Links

Collect additional information, taxes, or update your branding.

When you create a payment link, you can customize the look and feel of a checkout session for your user. You can also choose what type of customer information to collect and save for later.

Collect customer addresses and phone numbers

A payment link automatically collects your customer’s billing address when required for completing the purchase.

You can configure Payment Links to always collect a billing address, or always collect both a billing and a shipping address. When you collect shipping addresses, you can define the allowed values for shipping countries, and create one or more shipping rates to include in your link. Learn more about shipping addresses and shipping rates.

You can configure Payment Links to collect a phone number for shipping or invoicing. Only collect phone numbers if you need them for the transaction. When choosing this option, the payment page shows a required field to capture your customer’s phone number.

Collect business customer tax IDs

To display a customer’s tax ID and legal business name on invoices, enable tax ID collection on your Payment Links. Learn how to collect customer tax IDs with Checkout.

Collect taxes

Payment Links work with Stripe Tax to calculate and collect tax on your payments. Stripe Tax is a paid product that automatically calculates the tax on your transactions without the need to define the rates and rules.

Fees only apply after you’ve added at least one location where you’re registered to calculate and remit tax.

To get started, activate Stripe Tax in the Dashboard. Learn how to use products, prices, tax categories, and tax behavior to automatically calculate tax.

Collect agreement to your terms of service

You can require that your customers accept your terms of service before completing their purchase. When your terms of service URL is set in your account’s Public details, you have the option to require a terms of service agreement when you create a payment link in the Dashboard. Enabling this setting requires that your customers click a checkbox to accept your terms in their checkout page. The checkout page also links to your Privacy policy when a URL to your Privacy policy is set your public details.

Add custom fields

Don’t use custom fields to collect personal, protected, or sensitive data, or information restricted by law.

You can add custom fields on the payment form to collect additional information from your customers. The information is available after the payment is complete and is useful for fulfilling the purchase. You can add the following types of fields.

Type	Description
Text	Collects freeform text up to 255 characters.
Numbers only	Collects only numerical values up to 255 digits.
Dropdown	Presents your customers with a list of options to select from.

Click Add custom fields in the Options section.
Select a type of field to add.
Enter a label for the field.
(Optional) Mark your field as required.

Labels for custom fields aren’t translated, but you can use the locale URL parameter to set the language of your payment link to match the same language as your labels.

After your customer completes the payment, you can view the fields on the payment details page in the Dashboard.

The custom fields are also sent in the checkout.session.completed webhook upon payment completion.

Automatically convert prices to local currency

Enable automatic currency conversion in the Stripe Dashboard in test mode or live mode to automatically convert prices to an international customer’s local currency based on their location. Alternatively, you can set pricing manually for each currency using multi-currency prices. Learn more about how to present prices and charge payments in your customer’s local currency.

Save payment details for future use

Consult with your legal counsel or compliance team regarding saving and using payment details. For example, the European Data Protection Board issued guidance regarding the saving of payment details for faster future checkouts.

If you want to save the payment method information to provide returning customers an optional 1-click payment experience in the future, we recommend using Link.

To save payment details for a customer, select Save payment details for future use in the Advanced options section when you create a payment link. You can use the payment details to charge the customer again.

Apply branding

You can customize the look and feel of the payment page in the Stripe Dashboard. Go to your branding settings to:

Upload a logo or icon
Customize the payment page’s background color, button color, font, and shapes

Learn more about custom fonts and font compatibility.

Set store policies and contact information

You can display your return, refund, and legal policies on the payment page in addition to your support contact information.

Go to the Checkout and Payment Links settings to configure the information you want to display.

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

Customize checkout with URL parameters

Some URL parameters allow you to add additional context to your payment page and streamline checkout. You can configure URL parameters directly from the Stripe Dashboard, and use them in the query string of your payment link URL. From the payment links page, click a specific payment link, then click the dropdown menu on the Copy button to add URL parameters.

Here’s an example link with prefilled email, client reference ID, and locale.

https://buy.stripe.com/test_eVa3do41l4Ye6KkcMN?prefilled_email=jenny%40example.com&client_reference_id=id_1234&locale=de

Parameter Description Syntax

Parameter	Description	Syntax
`prefilled_email`	Use `prefilled_email` to enter an email address on the payment page automatically. Your end customer can still edit this field, so the email you pass in for `prefilled_email` might not be the same email that your customer uses to complete the payment.	`prefilled_email` must be a valid email address. Invalid values are silently dropped and your payment page continues to work as expected. We recommend encoding email addresses that you attach as URL parameters to reduce the risk of them not being passed through to your payment page.
`prefilled_promo_code`	Use `prefilled_promo_code` to enter a promotion code on the payment page automatically. Your customer can still edit this field, so the promotion code you pass in for `prefilled_promo_code` might not be the same promotion code that your customer uses to complete the payment. You must also enable promotion codes on your payment link, or this parameter has no effect.	`prefilled_promo_code` must be composed of alphanumeric characters and can’t use any special characters. Promotion codes are case insensitive. Invalid values are silently dropped, and your payment page continues to work as expected.
`locale`	Use `locale` to display your payment link in the same language for your customers regardless of their location.	View the complete list of all supported languages here.

prefilled_email

Use prefilled_email to enter an email address on the payment page automatically. Your end customer can still edit this field, so the email you pass in for prefilled_email might not be the same email that your customer uses to complete the payment.

prefilled_email must be a valid email address. Invalid values are silently dropped and your payment page continues to work as expected.

We recommend encoding email addresses that you attach as URL parameters to reduce the risk of them not being passed through to your payment page.

prefilled_promo_code

Use prefilled_promo_code to enter a promotion code on the payment page automatically. Your customer can still edit this field, so the promotion code you pass in for prefilled_promo_code might not be the same promotion code that your customer uses to complete the payment.

You must also enable promotion codes on your payment link, or this parameter has no effect.

prefilled_promo_code must be composed of alphanumeric characters and can’t use any special characters. Promotion codes are case insensitive. Invalid values are silently dropped, and your payment page continues to work as expected.

locale Use locale to display your payment link in the same language for your customers regardless of their location. View the complete list of all supported languages here.

You can also use URL parameters to track payment links and related campaigns.