# Fügt neuen Fehlercode für ungültige Mandats-Präfixe zu BACS-Lastschriftzahlungen und SEPA-Lastschriftzahlungen hinzu

## Das ändert sich

Fügt den [Fehlercode](https://docs.stripe.com/error-codes.md) `invalid_mandate_reference_prefix_format` als Enum-Wert zu den folgenden Ressourcen hinzu: [Payment Intents](https://docs.stripe.com/api/payment_intents.md?api-version=2024-09-30.acacia), [Setup Attempts](https://docs.stripe.com/api/setup_attempts.md?api-version=2024-09-30.acacia), [Setup Intents](https://docs.stripe.com/api/setup_intents.md?api-version=2024-09-30.acacia) und [Fehler](https://docs.stripe.com/api/errors.md?api-version=2024-09-30.acacia). Dies ermöglicht es Ihnen, Ihre Integration zu testen und Probleme mit dem Format von Referenzpräfixen in [Mandate](https://docs.stripe.com/api/mandates.md?api-version=2024-09-30.acacia), die sich auf [Bacs-Lastschriften](https://docs.stripe.com/payments/payment-methods/bacs-debit.md) und [SEPA-Lastschriften](https://docs.stripe.com/payments/sepa-debit.md) beziehen, leichter zu erkennen.

## Änderungen

#### REST API

| Parameters        | Change | Resources or endpoints                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mandate_options` | Added  | [PaymentIntent#confirm.payment_method_options.bacs_debit](/api/payment_intents/confirm?api-version=2024-09-30.acacia#confirm_payment_intent-payment_method_options-bacs_debit), [PaymentIntent#create.payment_method_options.bacs_debit](/api/payment_intents/create?api-version=2024-09-30.acacia#create_payment_intent-payment_method_options-bacs_debit), [PaymentIntent#update.payment_method_options.bacs_debit](/api/payment_intents/update?api-version=2024-09-30.acacia#update_payment_intent-payment_method_options-bacs_debit), [PaymentIntent.payment_method_options.bacs_debit](/api/payment_intents/object?api-version=2024-09-30.acacia#payment_intent_object-payment_method_options-bacs_debit) |
| `bacs_debit`      | Added  | [SetupIntent#confirm.payment_method_options](/api/setup_intents/confirm?api-version=2024-09-30.acacia#confirm_setup_intent-payment_method_options), [SetupIntent#create.payment_method_options](/api/setup_intents/create?api-version=2024-09-30.acacia#create_setup_intent-payment_method_options), [SetupIntent#update.payment_method_options](/api/setup_intents/update?api-version=2024-09-30.acacia#update_setup_intent-payment_method_options), [SetupIntent.payment_method_options](/api/setup_intents/object?api-version=2024-09-30.acacia#setup_intent_object-payment_method_options)                                                                                                                 |

| Value                                     | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invalid_mandate_reference_prefix_format` | Added  | [Invoice.last_finalization_error.code](/api/invoices/object?api-version=2024-09-30.acacia#invoice_object-last_finalization_error-code), [PaymentIntent.last_payment_error.code](/api/payment_intents/object?api-version=2024-09-30.acacia#payment_intent_object-last_payment_error-code), [SetupAttempt.setup_error.code](/api/setup_attempts/object?api-version=2024-09-30.acacia#setup_attempt_object-setup_error-code), [SetupIntent.last_setup_error.code](/api/setup_intents/object?api-version=2024-09-30.acacia#setup_intent_object-last_setup_error-code), [StripeError.code](/api/errors?api-version=2024-09-30.acacia#errors-code) |

#### Ruby

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

#### Python

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

#### PHP

| Value                                     | Change | Enum                                                                      |
| ----------------------------------------- | ------ | ------------------------------------------------------------------------- |
| `invalid_mandate_reference_prefix_format` | Added  | [StripeError.code](/api/errors?api-version=2024-09-30.acacia#errors-code) |

#### Java

| Parameters        | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mandate_options` | Added  | [PaymentIntent.payment_method_options.bacs_debit](/api/payment_intents/object?api-version=2024-09-30.acacia#payment_intent_object-payment_method_options-bacs_debit), [PaymentIntentConfirmParams.payment_method_options.bacs_debit](/api/payment_intents/confirm?api-version=2024-09-30.acacia#confirm_payment_intent-payment_method_options-bacs_debit), [PaymentIntentCreateParams.payment_method_options.bacs_debit](/api/payment_intents/create?api-version=2024-09-30.acacia#create_payment_intent-payment_method_options-bacs_debit), [PaymentIntentUpdateParams.payment_method_options.bacs_debit](/api/payment_intents/update?api-version=2024-09-30.acacia#update_payment_intent-payment_method_options-bacs_debit) |
| `bacs_debit`      | Added  | [SetupIntent.payment_method_options](/api/setup_intents/object?api-version=2024-09-30.acacia#setup_intent_object-payment_method_options), [SetupIntentConfirmParams.payment_method_options](/api/setup_intents/confirm?api-version=2024-09-30.acacia#confirm_setup_intent-payment_method_options), [SetupIntentCreateParams.payment_method_options](/api/setup_intents/create?api-version=2024-09-30.acacia#create_setup_intent-payment_method_options), [SetupIntentUpdateParams.payment_method_options](/api/setup_intents/update?api-version=2024-09-30.acacia#update_setup_intent-payment_method_options)                                                                                                                 |

#### Node.js

| Parameters        | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mandate_options` | Added  | [PaymentIntent.payment_method_options.bacs_debit](/api/payment_intents/object?api-version=2024-09-30.acacia#payment_intent_object-payment_method_options-bacs_debit), [PaymentIntentConfirmParams.payment_method_options.bacs_debit](/api/payment_intents/confirm?api-version=2024-09-30.acacia#confirm_payment_intent-payment_method_options-bacs_debit), [PaymentIntentCreateParams.payment_method_options.bacs_debit](/api/payment_intents/create?api-version=2024-09-30.acacia#create_payment_intent-payment_method_options-bacs_debit), [PaymentIntentUpdateParams.payment_method_options.bacs_debit](/api/payment_intents/update?api-version=2024-09-30.acacia#update_payment_intent-payment_method_options-bacs_debit) |
| `bacs_debit`      | Added  | [SetupIntent.payment_method_options](/api/setup_intents/object?api-version=2024-09-30.acacia#setup_intent_object-payment_method_options), [SetupIntentConfirmParams.payment_method_options](/api/setup_intents/confirm?api-version=2024-09-30.acacia#confirm_setup_intent-payment_method_options), [SetupIntentCreateParams.payment_method_options](/api/setup_intents/create?api-version=2024-09-30.acacia#create_setup_intent-payment_method_options), [SetupIntentUpdateParams.payment_method_options](/api/setup_intents/update?api-version=2024-09-30.acacia#update_setup_intent-payment_method_options)                                                                                                                 |

| Value                                     | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invalid_mandate_reference_prefix_format` | Added  | [Invoice.last_finalization_error.code](/api/invoices/object?api-version=2024-09-30.acacia#invoice_object-last_finalization_error-code), [PaymentIntent.last_payment_error.code](/api/payment_intents/object?api-version=2024-09-30.acacia#payment_intent_object-last_payment_error-code), [SetupAttempt.setup_error.code](/api/setup_attempts/object?api-version=2024-09-30.acacia#setup_attempt_object-setup_error-code), [SetupIntent.last_setup_error.code](/api/setup_intents/object?api-version=2024-09-30.acacia#setup_intent_object-last_setup_error-code), [StripeError.code](/api/errors?api-version=2024-09-30.acacia#errors-code) |

#### Go

| Parameters       | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MandateOptions` | Added  | [PaymentIntentConfirmPaymentMethodOptionsBacsDebitParams](/api/payment_intents/confirm?api-version=2024-09-30.acacia#confirm_payment_intent-payment_method_options-bacs_debit), [PaymentIntentPaymentMethodOptionsBacsDebitParams](/api/payment_intents/create?api-version=2024-09-30.acacia#create_payment_intent-payment_method_options-bacs_debit), [PaymentIntentPaymentMethodOptionsBacsDebit](/api/payment_intents/object?api-version=2024-09-30.acacia#payment_intent_object-payment_method_options-bacs_debit) |
| `BACSDebit`      | Added  | [SetupIntentConfirmPaymentMethodOptionsParams](/api/setup_intents/confirm?api-version=2024-09-30.acacia#confirm_setup_intent-payment_method_options), [SetupIntentPaymentMethodOptionsParams](/api/setup_intents/create?api-version=2024-09-30.acacia#create_setup_intent-payment_method_options), [SetupIntentPaymentMethodOptions](/api/setup_intents/object?api-version=2024-09-30.acacia#setup_intent_object-payment_method_options)                                                                               |

| Value                                     | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invalid_mandate_reference_prefix_format` | Added  | [InvoiceLastFinalizationErrorCode](/api/invoices/object?api-version=2024-09-30.acacia#invoice_object-last_finalization_error-code), [PaymentIntentLastPaymentErrorCode](/api/payment_intents/object?api-version=2024-09-30.acacia#payment_intent_object-last_payment_error-code), [SetupAttemptSetupErrorCode](/api/setup_attempts/object?api-version=2024-09-30.acacia#setup_attempt_object-setup_error-code), [SetupIntentLastSetupErrorCode](/api/setup_intents/object?api-version=2024-09-30.acacia#setup_intent_object-last_setup_error-code), [StripeErrorCode](/api/errors?api-version=2024-09-30.acacia#errors-code) |

#### .NET

| Parameters       | Change | Resources or methods                                                                                                                                                                                                                                                                                                                    |
| ---------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MandateOptions` | Added  | [PaymentIntentPaymentMethodOptionsBacsDebitOptions](/api/payment_intents/create?api-version=2024-09-30.acacia#create_payment_intent-payment_method_options-bacs_debit), [PaymentIntentPaymentMethodOptionsBacsDebit](/api/payment_intents/object?api-version=2024-09-30.acacia#payment_intent_object-payment_method_options-bacs_debit) |
| `BacsDebit`      | Added  | [SetupIntentPaymentMethodOptionsOptions](/api/setup_intents/create?api-version=2024-09-30.acacia#create_setup_intent-payment_method_options), [SetupIntentPaymentMethodOptions](/api/setup_intents/object?api-version=2024-09-30.acacia#setup_intent_object-payment_method_options)                                                     |

## 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-09-30.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&nbsp;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.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.0.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&nbsp;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.0.0](https://github.com/stripe/stripe-python/releases/tag/v11.0.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&nbsp;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.0.0](https://github.com/stripe/stripe-php/releases/tag/v16.0.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&nbsp;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 [v27.0.0](https://github.com/stripe/stripe-java/releases/tag/v27.0.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&nbsp;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.0.0](https://github.com/stripe/stripe-node/releases/tag/v17.0.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&nbsp;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 [v80.0.0](https://github.com/stripe/stripe-go/releases/tag/v80.0.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&nbsp;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 [v46.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v46.0.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&nbsp;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).

## Zugehörige Änderungen

- [Fügt einen Fehlercode für überschrittene Transaktionsgrenzen hinzu](https://docs.stripe.com/changelog/acacia/2024-09-30/error-code-transaction-limit.md)
