Breaking changes
Introduces the statement_description field and logic for how charges, invoices, plans, and transfers render statement descriptors Breaking changes
What’s new
Replaces the statement_description property on the Charge, Invoice, Plan, and Transfer objects with statement_descriptor. To determine what appears on a customer’s transaction, statement_description is appended to your Stripe account’s statement descriptor while statement_descriptor sets the full statement value. If not on this API version or newer, providing a statement_descriptor still triggers the statement_description behaviour. Regardless of API version, the statement_description behaviour doesn’t apply with PaymentIntents.
Impact
Replacing the statement_description property with statement_descriptor on multiple objects offers more control over statement appearance.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| statement_descriptor | Added | Charge Invoice Payout + 2 more Plan Transfer |
| statement_description | Removed | Charge Invoice Payout + 2 more Plan Transfer |
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: 2014-12-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.