Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Adds default value to custom fields on Payment Links


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_valueAddedPaymentLink#create.custom_fields[].dropdown PaymentLink#create.custom_fields[].numeric PaymentLink#create.custom_fields[].text + 6 more PaymentLink#update.custom_fields[].dropdown PaymentLink#update.custom_fields[].numeric PaymentLink#update.custom_fields[].text PaymentLink.custom_fields[].dropdown PaymentLink.custom_fields[].numeric PaymentLink.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
  1. Upgrade the API version used for webhook endpoints .
  2. Test your integration against the new version.
  3. If you use Connect, test your Connect integration .
  4. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Last verified 2026-09-24

Is this helpful?