Adds support for Twint as a payment method for recurring payments
What’s new
Adds support for Twint as a payment method for recurring payments to the following:
- Stripe Billing : Use Twint for Subscriptions and Invoices .
- Checkout Sessions : Use Twint in setup and subscription modes.
- PaymentIntents : Set setup_future_usage to off _ session to save Twint as a payment method for future use.
- SetupIntents : Create a Mandate without an initial payment.
- The Charge object now includes a mandate property in payment _ method _ details. twint that contains the ID of the mandate used for off-session payments.
- For client-side integrations, you can use the new stripe.confirmTwintSetup API method in Stripe.js to confirm SetupIntents with Twint payment methods.
Impact
You can now offer your customers Twint as a payment method for subscriptions, future purchases, recurring billing, and off-session payments. Learn how to set up future payments with Twint.
Twint allows only one active mandate per merchant-customer pair. If you try to create a new mandate when one already exists, the API returns a payment_intent_mandate_revoked_mandate_collision error. To learn how to handle this error, see support.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| mandate | Added | Charge. payment_method_details. twint PaymentAttemptRecord. payment_method_details. twint PaymentRecord. payment_method_details. twint |
| twint | Added | Mandate. payment_method_details SetupAttempt. payment_method_details |
| Value | Change | Enums |
| twint | Added | Invoice#update. payment_settings Invoice#create. payment_settings Invoice. payment_settings + 3 more Subscription#update. payment_settings Subscription#create. payment_settings Subscription. payment_settings |
| Fields | Change | From → to |
| Checkout. Session#create. payment_method_options. twint. setup_future_usage Checkout. Session. payment_method_options. twint. setup_future_usage PaymentIntent#confirm. payment_method_options. twint. setup_future_usage PaymentIntent#create. payment_method_options. twint. setup_future_usage PaymentIntent#update. payment_method_options. twint. setup_future_usage PaymentIntent. payment_method_options. twint. setup_future_usage | Changed | literal('none') → enum('none'|'off_session') |
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-05-27. 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.