• Breaking changes
• Public preview

Adds Mastercard support to Issuing Settlement API Breaking changes Public preview

What’s new

You can now retrieve settlement reports for Mastercard transactions alongside existing support for Visa and Maestro networks. Adds mastercard as an enum value to the network property of Issuing Settlement objects.

The mastercard enum value is available when creating test-mode settlements in a sandbox.

This extends Issuing Settlement functionality to support Mastercard settlement flows for externally-funded issuer processor programs, enabling comprehensive settlement reporting across all major card networks.

Why is this a breaking change?

Adding enum values to existing properties is a breaking change. If your integration validates the network property against a fixed list of values, it rejects the mastercard value and causes errors.

Impact

For Mastercard Issuer Processor programs, you can now use settlement data to confirm final amounts owed to Mastercard and reconcile settlement totals back to underlying transactions, disputes, and fees.

If your integration processes Issuing Settlement objects, update your code to handle the mastercard network value. This is important if you:

• Validate the network property against a predefined list of enum values
• Use conditional logic based on the network type
• Display network information to users

Changes

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: 2026-05-27. preview

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.