Adds support for setting the capture method for specific payment methods with the Checkout Sessions API
What’s new
Adds the new capture_method parameter to payment_method_options when creating Checkout Sessions for the following payment methods:
- Affirm
- Afterpay Clearpay
- Alma
- Amazon Pay
- Billie
- Card
- Cash App Pay
- Klarna
- Link
- MobilePay
- Revolut Pay
- Satispay
Impact
If your integration uses manual capture with Checkout, you can now enable it selectively for supported payment methods while maintaining automatic capture for others. This eliminates the previous limitations where enabling manual capture would either remove unsupported payment methods from the UI or cause errors when explicitly requested.
Changes
Upgrade
- View your current API version in Workbench.
- 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-09-30. clover
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.
Related changes
- Removes postal code for card payments in certain regions on Checkout and Payment Element
- Removes currency conversion field from Checkout Sessions
- Removes support for the redirectToCheckout method
- Updates initCheckout to be synchronous
- Adds support for collecting business and individual names in Checkout Sessions
- Adds the ability to exclude payment methods from Checkout Sessions and Payment Intents
- Adds support for configuring branding settings for Checkout Sessions
- Enables specifying units of measurement for Products
