# Fügt ein reguliertes Statusfeld in mehreren APIs zu Kartenobjekten hinzu

## Das ändert sich

Gibt den regulierten Status einer Karte an, der zeigt, ob eine Karte in einen regulierten Kontobereich fällt. Sie können diesen Status im Feld `regulated_status` in mehreren API-Ressourcen sehen: [Zahlung](https://docs.stripe.com/api/charges.md?api-version=2024-12-18.acacia), [Zahlungsmethoden](https://docs.stripe.com/api/payment_methods.md?api-version=2024-12-18.acacia) und [Token](https://docs.stripe.com/api/tokens.md?api-version=2024-12-18.acacia).

## Ergebnis

Der regulierte Status gibt an, ob eine Karte unter einen regulierten Kontobereich fällt.

## Änderungen

#### REST API

| Parameter          | Change | Resources or endpoints                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `regulated_status` | Added  | [Card](/api/issuing/cards/object?api-version=2024-12-18.acacia), [Charge.payment_method_details.card](/api/charges/object?api-version=2024-12-18.acacia#charge_object-payment_method_details-card), [ConfirmationToken.payment_method_preview.card](/api/confirmation_tokens/object?api-version=2024-12-18.acacia#confirmation_token_object-payment_method_preview-card), [PaymentMethod.card](/api/payment_methods/object?api-version=2024-12-18.acacia#payment_method_object-card) |

#### Ruby

Diese Änderung wirkt sich nicht auf das Ruby SDK aus.

#### Python

| Parameter          | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `regulated_status` | Added  | [stripe.Card](/api/issuing/cards/object?api-version=2024-12-18.acacia), [stripe.Charge.PaymentMethodDetails.Card](/api/charges/object?api-version=2024-12-18.acacia#charge_object-payment_method_details-card), [stripe.ConfirmationToken.PaymentMethodPreview.Card](/api/confirmation_tokens/object?api-version=2024-12-18.acacia#confirmation_token_object-payment_method_preview-card), [stripe.PaymentMethod.Card](/api/payment_methods/object?api-version=2024-12-18.acacia#payment_method_object-card) |

#### PHP

| Parameter          | Change | Resources or methods                                            |
| ------------------ | ------ | --------------------------------------------------------------- |
| `regulated_status` | Added  | [Card](/api/issuing/cards/object?api-version=2024-12-18.acacia) |

#### Java

| Parameter          | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `regulated_status` | Added  | [Card](/api/issuing/cards/object?api-version=2024-12-18.acacia), [Charge.payment_method_details.card](/api/charges/object?api-version=2024-12-18.acacia#charge_object-payment_method_details-card), [ConfirmationToken.payment_method_preview.card](/api/confirmation_tokens/object?api-version=2024-12-18.acacia#confirmation_token_object-payment_method_preview-card), [PaymentMethod.card](/api/payment_methods/object?api-version=2024-12-18.acacia#payment_method_object-card) |

#### Node.js

| Parameter          | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `regulated_status` | Added  | [Card](/api/issuing/cards/object?api-version=2024-12-18.acacia), [Charge.payment_method_details.card](/api/charges/object?api-version=2024-12-18.acacia#charge_object-payment_method_details-card), [ConfirmationToken.payment_method_preview.card](/api/confirmation_tokens/object?api-version=2024-12-18.acacia#confirmation_token_object-payment_method_preview-card), [PaymentMethod.card](/api/payment_methods/object?api-version=2024-12-18.acacia#payment_method_object-card) |

#### Go

| Parameter         | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `RegulatedStatus` | Added  | [Card](/api/issuing/cards/object?api-version=2024-12-18.acacia), [ChargePaymentMethodDetailsCard](/api/charges/object?api-version=2024-12-18.acacia#charge_object-payment_method_details-card), [ConfirmationTokenPaymentMethodPreviewCard](/api/confirmation_tokens/object?api-version=2024-12-18.acacia#confirmation_token_object-payment_method_preview-card), [PaymentMethodCard](/api/payment_methods/object?api-version=2024-12-18.acacia#payment_method_object-card) |

#### .NET

| Parameter         | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `RegulatedStatus` | Added  | [Card](/api/issuing/cards/object?api-version=2024-12-18.acacia), [ChargePaymentMethodDetailsCard](/api/charges/object?api-version=2024-12-18.acacia#charge_object-payment_method_details-card), [ConfirmationTokenPaymentMethodPreviewCard](/api/confirmation_tokens/object?api-version=2024-12-18.acacia#confirmation_token_object-payment_method_preview-card), [PaymentMethodCard](/api/payment_methods/object?api-version=2024-12-18.acacia#payment_method_object-card) |

## Upgrade

#### REST API

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
   - Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre [API-Anfragen](https://docs.stripe.com/api/versioning.md) auf `Stripe-Version: 2024-12-18.acacia`
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Ruby SDK auf [v13.3.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.3.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Python SDK auf [v11.4.0](https://github.com/stripe/stripe-python/releases/tag/v11.4.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr PHP SDK auf [v16.4.0](https://github.com/stripe/stripe-php/releases/tag/v16.4.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Java SDK auf [v28.2.0](https://github.com/stripe/stripe-java/releases/tag/v28.2.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Node SDK auf [v17.5.0](https://github.com/stripe/stripe-node/releases/tag/v17.5.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Go SDK auf [v81.2.0](https://github.com/stripe/stripe-go/releases/tag/v81.2.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr .NET SDK auf [v47.2.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.2.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).