Adds payment method options for Sunbit in Checkout Sessions
What’s new
Adds support for payment_method_options.sunbit on the Checkout Session object. You can now configure the following options when using Sunbit as a payment method in a Checkout Session:
- capture_method : Controls when funds are captured from the customer’s account. Set to manual to place a hold on funds and capture them later.
- setup_future_usage : Indicates whether you intend to make future payments with the payment method collected in this session. Set to none to indicate no future usage.
These options are available on both the POST /the relevant part of the product request and the GET /the relevant part of the product/:id response.
Impact
You can now set capture_method and setup_future_usage at the payment_method_options.sunbit level to override the top-level values set on the Checkout Session. You can also use manual capture with Sunbit payments in Checkout Sessions, giving you greater control over when funds are captured after authorization. To use manual capture, set capture_method to manual when you create a Checkout Session.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| sunbit | Added | Checkout. Session#create. payment_method_options Checkout. Session. payment_method_options |
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: 2026-06-24. dahlia
- 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
- Adds buyer ID support for Bizum payments
- Enables manual capture for Sunbit payments
- Adds buyer ID support for the related setting payments
- Adds a fingerprint to Pix payment method details
- Adds transaction link ID to card payment method details for Mastercard and Maestro transactions
- Adds support for the Sui network and USDsui token for crypto payments
- Adds support for Mastercard compliance disputes
- Adds support for recurring payments with Satispay