# クレジット付与を特定の価格に適用できるようになりました ## 新規情報 [クレジット付与を作成](https://docs.stripe.com/api/billing/credit-grant/create.md?api-version=2025-02-24.acacia#create_billing_credit_grant-applicability_config-scope-price_type)する際に、クレジット付与の[範囲](https://docs.stripe.com/api/billing/credit-grant/create.md?lang=curl&api-version=2025-02-24.acacia#create_billing_credit_grant-applicability_config-scope)を定義して、特定の`価格`のリストまたはクレジット付与に適用する [price_type](https://docs.stripe.com/api/billing/credit-grant/create.md?api-version=2025-02-24.acacia#create_billing_credit_grant-applicability_config-scope-price_type) を対象に含めることができるようになりました。クレジット付与の作成時に`、prices` または `price_type` を指定する必要があります。現在、`価格`リストでは従量制価格のみを指定でき、`price_type` では`従量制`価格のみがサポートされます。 ## 影響 この変更により、クレジット付与を適用できる価格を細かく制御できます。新しいフィールドを使用すると、指定した価格リストに適用されるすべてのクレジット付与の残高サマリーを取得できます。 ## 変更点 #### REST API | Parameters | Change | Resources or endpoints | | ---------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price_type`, `prices` | Added | `Billing.CreditBalanceSummary#retrieve.filter.applicability_scope`, `Billing.CreditGrant#create.applicability_config.scope`, `Billing.CreditGrant.applicability_config.scope` | #### Ruby この変更は、Ruby SDK には影響しません。 #### Python | Parameters | Change | Resources or methods | | ------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price_type` | Added | `stripe.billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope`, `stripe.billing.CreditGrant.CreateParamsApplicabilityConfigScope`, `stripe.billing.CreditGrant.ApplicabilityConfig.Scope` | | `prices` | Added | `stripe.billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope`, `stripe.billing.CreditGrant.CreateParamsApplicabilityConfigScope`, `stripe.billing.CreditGrant.ApplicabilityConfig.Scope` | #### PHP この変更は、PHP SDK には影響しません。 #### Java | Parameters | Change | Resources or methods | | ---------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price_type`, `prices` | Added | `Billing.CreditGrant.applicability_config.scope`, `billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, `billing.CreditGrantCreateParams.applicability_config.scope` | #### Node.js | Parameters | Change | Resources or methods | | ---------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price_type`, `prices` | Added | `Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, `Billing.CreditGrant.applicability_config.scope`, `Billing.CreditGrantCreateParams.applicability_config.scope` | #### Go | Parameters | Change | Resources or methods | | --------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `PriceType`, `Prices` | Added | `BillingCreditBalanceSummaryFilterApplicabilityScopeParams`, `BillingCreditGrantApplicabilityConfigScopeParams`, `BillingCreditGrantApplicabilityConfigScope` | #### .NET | Parameters | Change | Resources or methods | | --------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `PriceType`, `Prices` | Added | `BillingCreditBalanceSummaryFilterApplicabilityScopeOptions`, `BillingCreditGrantApplicabilityConfigScopeOptions`, `BillingCreditGrantApplicabilityConfigScope` | ## アップグレード #### 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: 2025-02-24.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.5.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.5.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.6.0](https://github.com/stripe/stripe-python/releases/tag/v11.6.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.6.0](https://github.com/stripe/stripe-php/releases/tag/v16.6.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.4.0](https://github.com/stripe/stripe-java/releases/tag/v28.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)について、詳細をご確認ください。 #### 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.7.0](https://github.com/stripe/stripe-node/releases/tag/v17.7.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.4.0](https://github.com/stripe/stripe-go/releases/tag/v81.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)について、詳細をご確認ください。 #### .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.4.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.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)について、詳細をご確認ください。 ## 関連する変更点 - [クレジット付与に優先順位を付けることができるようになりました](https://docs.stripe.com/changelog/acacia/2025-02-24/billing-credits-priority.md)