Breaking changes
Renames account_balance to balance on Customer object Breaking changes
What’s new
Renames the Customer object’s account_balance value to balance. With this, a new Customer Balance Transactions API is available:
- Updates the customer’s balance by incrementing or decrementing its current value by a specified amount and attaching metadata to the change.
- Retrieves a history of changes to the customer’s balance .
Impact
By renaming the account_balance property to balance, the terminology is now better aligned with common usage. Additionally, the new Customer Balance Transactions API provides you with the ability to directly update a customer’s balance by incrementing or decrementing the value, as well as attach metadata to these balance changes.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| account_balance | Removed | Customer Customer#create Customer#update |
| balance | Added | Customer |
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: 2019-10-17
- 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.