URL parameters allow you to add additional context to your payment page and streamline checkout. Specify the language that appears during checkout, prefill an email address or promotional code for your customers, track campaigns, and streamline reconciliation.
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, promotional code, and locale parameters.
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 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 to display your payment link in a specific language for your customers regardless of their location.
|View the complete list of all supported languages.|
You can also use URL parameters to track payment links and related campaigns.