Adds the ability to update shipping options, consent collection, and future usage support on Payment Links

What’s new

Adds support for three additional parameters when updating a Payment Link:

• shipping_options: Accepts an array of up to five shipping rate objects, each with a shipping_rate ID corresponding to an existing Shipping Rate. Pass an empty array to remove all shipping options from a Payment Link.
• consent_collection: Lets you update the following consent collection settings on an existing Payment Link:
• consent_collection.payment_method_reuse_agreement.position : Controls where the payment method reuse agreement is displayed.
• consent_collection.promotions : Controls whether to display a checkbox for promotional communications consent.
• consent_collection.terms_of_service : Controls whether to display a checkbox for terms of service acceptance.
• payment_intent_data.setup_future_usage: Set to on_session or off_session to indicate how you intend to reuse the payment method collected during the Checkout Session. Previously, API requests that included this parameter returned a 400 error.

Previously, these parameters were only configurable through the Dashboard.

Impact

You can now programmatically manage shipping options, consent collection, and future payment usage on existing Payment Links without using the Dashboard. Together, these additions make it possible to use the API to build automated workflows that update Payment Link configuration in response to changes in your business logic including recurring payment setups, shipping rate changes, and consent policy updates.

Changes

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: 2026-07-29. dahlia

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 .

Learn more about Stripe API upgrades.

Related changes

• Adds the ability to indicate that you don’t intend to reuse Samsung Pay and the related setting payment method types
• Adds customer and payment method details to the Refunds API
• Adds support for new banks to FPX payments
• Adds the related setting as a supported network for funding instructions
• Adds the allowed payment method types parameter to Payment Intents and Setup Intents
• Adds MB WAY support to the hosted invoice page
• Adds card network details to the Dispute object
• Adds the ability to list Payment Records