# テスト環境のオーソリで、加盟店の金額と通貨のサポートを追加 ## 新機能 [テスト環境のオーソリを作成](https://docs.stripe.com/api/issuing/authorizations/test_mode_create.md?api-version=2024-11-20.acacia)する際に、オプションで [merchant_amount](https://docs.stripe.com/api/issuing/authorizations/test_mode_create.md?api-version=2024-11-20.acacia#test_mode_create_authorization-merchant_amount) と [merchant_currency](https://docs.stripe.com/api/issuing/authorizations/test_mode_create.md?api-version=2024-11-20.acacia#test_mode_create_authorization-merchant_currency) を指定できるようになりました。 ## 影響 [merchant_amount](https://docs.stripe.com/api/issuing/authorizations/test_mode_create.md?api-version=2024-11-20.acacia#test_mode_create_authorization-merchant_amount) と [merchant_currency](https://docs.stripe.com/api/issuing/authorizations/test_mode_create.md?api-version=2024-11-20.acacia#test_mode_create_authorization-merchant_currency) を使用して、加盟店のクレジットカード通貨とは異なる通貨を持つ[有効なオーソリ](https://docs.stripe.com/api/issuing/authorizations.md?api-version=2024-11-20.acacia)を作成できます。 `merchant_amount` が追加されると、[amount](https://docs.stripe.com/api/issuing/authorizations/object.md?api-version=2024-11-20.acacia#issuing_authorization_object-amount) パラメーターはオプションになります。テスト環境のオーソリの作成時に `amount` または `merchant_amount` を指定できます。 ## 変更点 #### REST API | Endpoint | Change | Resource | | --------- | ------ | ----------------------------------------------------------------------------------------- | | `respond` | Added | [Issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) | | Parameters | Change | Resources or endpoints | | -------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------- | | `merchant_amount`, `merchant_currency` | Added | [Issuing.Authorization.testHelpers#create](/api/issuing/authorizations/test_mode_create?api-version=2024-11-20.acacia) | | Field | Change | From → to | | ------------------------------------------------- | ------- | --------------------- | | `Issuing.Authorization.testHelpers#create.amount` | Changed | `required → optional` | #### Ruby | Method | Change | Resource | | --------- | ------ | ----------------------------------------------------------------------------------------- | | `respond` | Added | [Issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) | #### Python | Parameters | Change | Resources or methods | | -------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------- | | `merchant_amount`, `merchant_currency` | Added | [stripe.issuing.Authorization.CreateParams](/api/issuing/authorizations/test_mode_create?api-version=2024-11-20.acacia) | | `respond` | Added | [stripe.issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) | | Fields | Change | From → to | | ----------------------------------------------------- | ------- | ------------------------ | | `amount`, `stripe.issuing.Authorization.CreateParams` | Changed | `int → NotRequired[int]` | #### PHP | Method | Change | Resource | | --------- | ------ | ----------------------------------------------------------------------------------------- | | `respond` | Added | [Issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) | #### Java | Method | Change | Resource | | --------- | ------ | ----------------------------------------------------------------------------------------- | | `respond` | Added | [Issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) | | Parameters | Change | Resources or methods | | -------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------- | | `merchant_amount`, `merchant_currency` | Added | [issuing.AuthorizationCreateParams](/api/issuing/authorizations/test_mode_create?api-version=2024-11-20.acacia) | | Field | Change | From → to | | ------------------------------------------ | ------- | --------------------- | | `issuing.AuthorizationCreateParams.amount` | Changed | `required → optional` | #### Node.js | Method | Change | Resource | | --------- | ------ | ----------------------------------------------------------------------------------------- | | `respond` | Added | [Issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) | | Parameters | Change | Resources or methods | | -------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- | | `merchant_amount`, `merchant_currency` | Added | [Issuing.AuthorizationCreateParams.testHelpers](/api/issuing/authorizations/test_mode_create?api-version=2024-11-20.acacia) | | Field | Change | From → to | | ------------------------------------------------------ | ------- | --------------------- | | `Issuing.AuthorizationCreateParams.testHelpers.amount` | Changed | `required → optional` | #### Go | Method | Change | Resource | | --------- | ------ | ----------------------------------------------------------------------------------------- | | `Respond` | Added | [Issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) | | Parameters | Change | Resources or methods | | ------------------------------------ | ------ | ---------------------------------------------------------------------------------------------- | | `MerchantAmount`, `MerchantCurrency` | Added | [IssuingAuthorizationParams](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) | #### .NET | Method | Change | Resource | | --------- | ------ | ----------------------------------------------------------------------------------------- | | `Respond` | Added | [Issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) | | Parameters | Change | Resources or methods | | ------------------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------- | | `MerchantAmount`, `MerchantCurrency` | Added | [Issuing.TestHelpersAuthorizationCreateOptions](/api/issuing/authorizations/test_mode_create?api-version=2024-11-20.acacia) | ## アップグレード #### 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-11-20.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.2.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.2.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.3.0](https://github.com/stripe/stripe-python/releases/tag/v11.3.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.3.0](https://github.com/stripe/stripe-php/releases/tag/v16.3.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 を [v28.1.0](https://github.com/stripe/stripe-java/releases/tag/v28.1.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.4.0](https://github.com/stripe/stripe-node/releases/tag/v17.4.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 を [v81.1.0](https://github.com/stripe/stripe-go/releases/tag/v81.1.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 を [v47.1.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.1.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-11-20/issuing-fraud-challenges.md)