Stripe’s Payment Links feature allows you to create a secure, Stripe-hosted payment page that can be used to accept donations. URL parameters can be used to customize the checkout experience and track campaigns. Based on the search results, here are some of the URL parameters that can be used with Stripe’s Payment Links:
prefilled_email: Prefills the email address field on the payment page.prefilled_promo_code: Applies a promotional code if promotion codes are enabled on your payment link.locale: Specifies the language of the payment link for your customers.utm_source,utm_medium,utm_campaign,utm_term,utm_content: UTM parameters for tracking the source and effectiveness of marketing campaigns.client_reference_id: Attaches a unique identifier to the Checkout Session for reconciliation with internal systems.
These parameters can be added to the query string of your payment link URL to prefill certain fields, track marketing campaigns, or streamline the checkout process for your customers. For example, a payment link with prefilled email and locale parameters might look like this:
https://buy.stripe.com/test_eVa3do41l4Ye6KkcMN?prefilled_email=jenny%40example.com&locale=de
To use these parameters, you can configure them directly from the Stripe Dashboard by selecting the payment link you want to modify and adding the desired parameters[2][5].
It’s important to note that while URL parameters can be used to customize the checkout experience, the search results do not indicate that there is a direct way to predefine or make the donation amount field read-only through URL parameters. For custom functionality like initializing the donation amount field with a specific value and making it read-only, you might need to implement a custom solution using Stripe’s API or consult Stripe’s documentation and support for further guidance[1][4].
Citations: [1] https://stackoverflow.com/questions/75756367/stripe-donation-payment-link-how-to-initialize-the-amount-from-url-or-javascrip [2] https://docs.stripe.com/payment-links/customize [3] https://support.stripe.com/questions/how-to-accept-donations-through-stripe [4] https://docs.stripe.com/api/payment_links/payment_links/create [5] https://docs.stripe.com/payment-links/url-parameters [6] https://donorbox.zendesk.com/hc/en-us/articles/360052797571-Can-I-pass-data-to-a-URL-after-a-donation [7] https://docs.stripe.com/payment-links [8] https://youtube.com/watch?v=4hLXnU8SUko
Parameters
Based on the information provided in the search results, here are the available URL parameters for Stripe donation payment links that you’re interested in:
Prefilled Email
prefilled_email: This parameter allows you to prefill the email address field on the payment page. It’s useful for improving the user experience by reducing the amount of typing a donor needs to do. For example, appending?prefilled_email=jenny%40example.comto your payment link URL will prefill the email field with “jenny@example.com”[1].
Client Reference ID
client_reference_id: Use this parameter to attach a unique string of your choice to the Checkout Session. This can be a customer ID, a cart ID, or similar, and you can use it to reconcile the session with your internal systems. Theclient_reference_idis sent in thecheckout.session.completedwebhook after payment completion. This parameter is useful for tracking donations or purchases back to your internal records[5].
Locale
locale: This parameter specifies the language of the payment link for your customers, regardless of their location. It’s useful for providing a localized experience to users in different regions. For example, appending?locale=deto your payment link URL will display the payment page in German[1].
UTM Parameters
- UTM Codes: These parameters are used for tracking how customers find your site when they pay using your payment link. You can add the following UTM codes as parameters in the query string of your URL:
utm_source,utm_medium,utm_campaign,utm_term, andutm_content. These parameters help identify the source of your traffic and the effectiveness of your marketing strategies[5].
Here’s an example of how you might combine these parameters in a single URL:
https://buy.stripe.com/test_eVa5nPg1j1wmfXq5kr?prefilled_email=jenny%40example.com&client_reference_id=12345&locale=de&utm_source=newsletter&utm_medium=email&utm_campaign=donation_campaign
This URL pre-fills the email address, sets a client reference ID, displays the payment page in German, and includes UTM parameters for tracking the source and campaign of the donation.
Citations: [1] https://docs.stripe.com/payment-links/customize [2] https://stackoverflow.com/questions/68073724/prefill-customer-email-via-stripe-payment-link-url [3] https://stackoverflow.com/questions/63850669/stripe-payment-client-reference-id [4] https://docs.stripe.com/payments/checkout/customization [5] https://docs.stripe.com/payment-links/url-parameters [6] https://stackoverflow.com/questions/75756367/stripe-donation-payment-link-how-to-initialize-the-amount-from-url-or-javascrip [7] https://youtube.com/watch?v=zTrOl94NRZE [8] https://docs.stripe.com/api/payment_links/payment_links/object [9] https://docs.stripe.com/payments/checkout/custom-fields [10] https://docs.stripe.com/payment-links/post-payment [11] https://docs.stripe.com/payment-links [12] https://docs.stripe.com/payments/link/save-and-reuse [13] https://youtube.com/watch?v=uI9gJakNLQ8 [14] https://youtube.com/watch?v=kI1qwXGVLs8 [15] https://www.soliantconsulting.com/blog/stripe-payment-links/ [16] https://stripe.com/payments/payment-links [17] https://noorsplugin.com/how-to-prefill-email-addresses-for-stripe-payment-link-buttons/ [18] https://docs.stripe.com/api/payment_links/payment_links/create [19] https://docs.stripe.com/api/checkout/sessions/create [20] https://www.cjav.dev/articles/pass-data-through-stripe-payment-links [21] https://docs.stripe.com/payments/link/add-link-elements-integration [22] https://docs.stripe.com/payment-links/api [23] https://support.stripe.com/questions/how-to-accept-donations-through-stripe