Breaking changes
Adds a processing status to submitted stablecoin payments Breaking changes
What’s new
PaymentIntents confirmed with the crypto payment method for stablecoin payments now have a status of processing when a user submits a transaction to the blockchain for processing. Users only redirect back to your integration when a payment is finalised.
Impact
Previously, the PaymentIntent denoted success or failure by transitioning from requires_action to either succeeded or requires_payment_method.
With this change, when using the crypto payment method:
- If you retrieve the PaymentIntent while customers are waiting for the transaction to confirm, the status field now shows a value of processing .
- If you attempt to cancel a confirmed PaymentIntent with the processing status, the request fails with error payment _ intent _ invalid _ cancellation _ state .
You can optionally set up your webhook endpoint to listen for the payment_intent.processing event to be notified when the PaymentIntent transitions to the processing status.
The customer isn’t redirected while the PaymentIntent has the processing status, so your checkout experience shouldn’t require any 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 .
Learn more about Stripe API upgrades.