Skip to content
Create account
 or
Sign in
The Stripe Docs logo
/
Create account
Sign in

Adds default value to custom fields on Payment Links

What’s new

Adds the default_value parameter to the existing custom_fields[][text], custom_fields[][numeric] and custom_fields[][dropdown] parameters on the Create a Payment Link and Update a Payment Link endpoints.

Impact

Payment Links users can now provide a default value when using custom fields. Default values prefill the form field on the payment page.

Changes

ParameterChangeResources or endpoints
default_valueAdded
PaymentLink#update.custom_fields[].dropdownPaymentLink#update.custom_fields[].numericPaymentLink#update.custom_fields[].textPaymentLink.custom_fields[].dropdownPaymentLink.custom_fields[].numericPaymentLink.custom_fields[].text

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-03-31.basil
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc