Breaking changes

Changes statement descriptor behaviors for card payments created with Charges Breaking changes

What’s new

Changes statement descriptor behaviors for card payments created through /v1/charges. To learn more, see our guide on statement descriptors.

• Instead of using the platform’s statement descriptor, charges created with on _ behalf _ of or destination now use the descriptor of the connected account.
• The full statement descriptor for a card payment is no longer provided at charge creation. Dynamic descriptors provided at charge time are now prefixed by the descriptor prefix set in the dashboard or through the new settings[card _ payments][statement _ descriptor _ prefix] parameter in the Accounts API.
• If an account has no statement _ descriptor set, the account’s business or legal name is used as the statement descriptor.
• Statement descriptors can no longer contain * , , and "`.

Impact

This change alters how statement descriptors are handled for card payments created through the Charges API, providing more accurate branding for connected accounts and standardize descriptor formatting.

Upgrade

1. View your current API version in Workbench.
2. 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-02-19

3. Upgrade the API version used for webhook endpoints .
4. Test your integration against the new version.
5. If you use Connect, test your Connect integration .
6. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.