# Adds Mastercard support to Issuing Settlement API

## 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](https://docs.stripe.com/api/issuing/settlements/object.md?api-version=2026-05-27.preview#issuing_settlement_object-network) property of [Issuing Settlement](https://docs.stripe.com/api/issuing/settlements.md?api-version=2026-05-27.preview) objects.

The `mastercard` enum value is available when [creating test-mode settlements](https://docs.stripe.com/api/issuing/authorizations/test_mode_create.md?api-version=2026-05-27.preview) in a *sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes).

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](https://docs.stripe.com/api/issuing/settlements.md?api-version=2026-05-27.preview) 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

#### REST API

| Value        | Change | Enum                                                                                                                   |
| ------------ | ------ | ---------------------------------------------------------------------------------------------------------------------- |
| `mastercard` | Added  | [Issuing.Settlement](/api/issuing/settlements/object?api-version=2026-05-27.preview#issuing_settlement_object-network) |

#### Ruby

This change does not affect the Ruby SDK.

#### Python

| Value        | Change | Enum                                                                                                                   |
| ------------ | ------ | ---------------------------------------------------------------------------------------------------------------------- |
| `mastercard` | Added  | [Issuing.Settlement](/api/issuing/settlements/object?api-version=2026-05-27.preview#issuing_settlement_object-network) |

#### PHP

| Value        | Change | Enum                                                                                                                   |
| ------------ | ------ | ---------------------------------------------------------------------------------------------------------------------- |
| `mastercard` | Added  | [Issuing.Settlement](/api/issuing/settlements/object?api-version=2026-05-27.preview#issuing_settlement_object-network) |

#### Java

This change does not affect the Java SDK.

#### Node.js

| Value        | Change | Enum                                                                                                                   |
| ------------ | ------ | ---------------------------------------------------------------------------------------------------------------------- |
| `mastercard` | Added  | [Issuing.Settlement](/api/issuing/settlements/object?api-version=2026-05-27.preview#issuing_settlement_object-network) |

#### Go

| Value        | Change | Enum                                                                                                                  |
| ------------ | ------ | --------------------------------------------------------------------------------------------------------------------- |
| `mastercard` | Added  | [IssuingSettlement](/api/issuing/settlements/object?api-version=2026-05-27.preview#issuing_settlement_object-Network) |

#### .NET

This change does not affect the .NET SDK.

## Upgrade

#### REST API

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) 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](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2026-05-27.preview`
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Ruby SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Python SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your PHP SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Java SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Node SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Go SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your .NET SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).