Introduces new customer balance transaction types
What’s new
We’re introducing two new customer balance transaction types: checkout_session_subscription_payment and checkout_session_subscription_payment_canceled, and a new field checkout_session to the customer balance transaction.
Impact
This change affects users who use Checkout:
- When completing checkout, transactions made to the customer balance are marked as the checkout _ session _ subscription _ payment type and checkout _ session is populated by the corresponding session ID.
- If the session expires, this reverses the customer balance transaction and marks the reverse transaction as the checkout _ session _ subscription _ payment _ canceled type and checkout _ session is populated by the corresponding session ID.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| checkout_session | Added | CustomerBalanceTransaction |
| Values | Change | Enum |
| checkout_session_subscription_payment_canceled checkout_session_subscription_payment | Added | CustomerBalanceTransaction |
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-03-31. basil
- 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.