# 無効な同意書のプレフィックスの新しいエラーコードを Bacs ダイレクトデビット決済と SEPA ダイレクトデビット決済に追加しました ## 新機能 `invalid_mandate_reference_prefix_format` [エラーコード](https://docs.stripe.com/error-codes.md) を列挙値として [決済インテント](https://docs.stripe.com/api/payment_intents.md?api-version=2024-09-30.acacia)、[設定試行](https://docs.stripe.com/api/setup_attempts.md?api-version=2024-09-30.acacia)、[設定インテント](https://docs.stripe.com/api/setup_intents.md?api-version=2024-09-30.acacia)、[エラー](https://docs.stripe.com/api/errors.md?api-version=2024-09-30.acacia) リソースに追加します。これにより、統合をテストし、[Bacs ダイレクトデビット](https://docs.stripe.com/payments/payment-methods/bacs-debit.md) および [SEPA ダイレクトデビット](https://docs.stripe.com/payments/sepa-debit.md) の決済に関連する [同意書](https://docs.stripe.com/api/mandates.md?api-version=2024-09-30.acacia) の参照プレフィックスの形式に関する問題をより簡単に検出できます。 ## 変更点 #### 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 この変更は、Ruby SDK には影響しません。 #### Python この変更は、Python SDK には影響しません。 #### 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) | ## アップグレード #### REST API 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。 - SDK を使用していない場合は、`Stripe-Version: 2024-09-30.acacia` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Ruby 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Ruby SDK を [v13.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Python 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Python SDK を [v11.0.0](https://github.com/stripe/stripe-python/releases/tag/v11.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### PHP 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. PHP SDK を [v16.0.0](https://github.com/stripe/stripe-php/releases/tag/v16.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Java 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Java SDK を [v27.0.0](https://github.com/stripe/stripe-java/releases/tag/v27.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Node.js 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Node SDK を [v17.0.0](https://github.com/stripe/stripe-node/releases/tag/v17.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Go 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Go SDK を [v80.0.0](https://github.com/stripe/stripe-go/releases/tag/v80.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### .NET 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. .NET SDK を [v46.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v46.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 ## 関連する変更点 - [取引限度額を超えた場合のエラーコードを追加しました](https://docs.stripe.com/changelog/acacia/2024-09-30/error-code-transaction-limit.md)