# クレジットノートの明細項目にメタデータプロパティを追加 ## 新機能 [Credit Note Line Item](https://docs.stripe.com/api/credit_notes/line_item.md?api-version=2026-03-25.dahlia#credit_note_line_item_object-metadata) オブジェクトの新しい [metadata](https://docs.stripe.com/api/credit_notes/line_item.md?api-version=2026-03-25.dahlia) プロパティを使用して、キーと値のペアを個々の明細項目に関連付ける機能を追加します。 クレジットノートを[作成](https://docs.stripe.com/api/credit_notes/create.md?api-version=2026-03-25.dahlia)または[プレビュー](https://docs.stripe.com/api/credit_notes/preview.md?api-version=2026-03-25.dahlia)するときに、`lines` パラメーターで明細項目ごとに [metadata](https://docs.stripe.com/api/credit_notes/create.md?api-version=2026-03-25.dahlia#create_credit_note-lines-metadata) を指定できるようになりました。API はこのメタデータを、生成される Credit Note Line Item オブジェクトの一部として保存し、クレジットノートまたはその明細項目を取得するときに返します。 メタデータプロパティには、最大 50 個のキー、最大 40 文字のキー名、最大 500 文字の値を含めることができます。 ## 影響 カスタム情報を個々のクレジットノートの明細項目に関連付けて、内部追跡、レポート作成、ビジネスロジックに利用できるようになりました。たとえば、メタデータを使用して、内部製品コード、部門情報、またはクレジットノートの明細項目を分類および分析するのに役立つその他のビジネス固有のデータを保存できます。 ## 変更点 #### REST API | Parameter | Change | Resources or endpoints | | --- | --- | --- | | `metadata` | Added | [CreditNote#create.lines[]](/api/credit_notes/create?api-version=2026-03-25.dahlia#create_credit_note-lines), [CreditNote#preview.lines[]](/api/credit_notes/preview?api-version=2026-03-25.dahlia#preview_credit_note-lines), [CreditNote#preview_lines.lines[]](/api/credit_notes/preview_lines?api-version=2026-03-25.dahlia#credit_note_preview_lines-lines), [CreditNoteLineItem](/api/credit_notes/line_item?api-version=2026-03-25.dahlia) | #### Ruby | Parameter | Change | Resources or methods | | --- | --- | --- | | `metadata` | Added | [CreditNoteCreateParams::Line](/api/credit_notes/create?api-version=2026-03-25.dahlia#create_credit_note-lines), [CreditNoteLineItem](/api/credit_notes/line_item?api-version=2026-03-25.dahlia), [CreditNoteListPreviewLineItemsParams::Line](/api/credit_notes/preview_lines?api-version=2026-03-25.dahlia#credit_note_preview_lines-lines), [CreditNotePreviewParams::Line](/api/credit_notes/preview?api-version=2026-03-25.dahlia#preview_credit_note-lines) | #### Python | Parameter | Change | Resources or methods | | --- | --- | --- | | `metadata` | Added | [CreditNoteCreateParamsLine](/api/credit_notes/create?api-version=2026-03-25.dahlia#create_credit_note-lines), [CreditNoteLineItem](/api/credit_notes/line_item?api-version=2026-03-25.dahlia), [CreditNotePreviewLinesParamsLine](/api/credit_notes/preview_lines?api-version=2026-03-25.dahlia#credit_note_preview_lines-lines), [CreditNotePreviewParamsLine](/api/credit_notes/preview?api-version=2026-03-25.dahlia#preview_credit_note-lines) | #### PHP | Parameter | Change | Resources or methods | | --- | --- | --- | | `metadata` | Added | [CreditNote.create().$params.line](/api/credit_notes/create?api-version=2026-03-25.dahlia#create_credit_note-lines), [CreditNote.preview().$params.line](/api/credit_notes/preview?api-version=2026-03-25.dahlia#preview_credit_note-lines), [CreditNote.preview_lines().$params.line](/api/credit_notes/preview_lines?api-version=2026-03-25.dahlia#credit_note_preview_lines-lines), [CreditNoteLineItem](/api/credit_notes/line_item?api-version=2026-03-25.dahlia) | #### Java | Parameter | Change | Resources or methods | | --- | --- | --- | | `metadata` | Added | [CreditNoteCreateParams.lines[]](/api/credit_notes/create?api-version=2026-03-25.dahlia#create_credit_note-lines), [CreditNoteLineItem](/api/credit_notes/line_item?api-version=2026-03-25.dahlia), [CreditNotePreviewLinesParams.lines[]](/api/credit_notes/preview_lines?api-version=2026-03-25.dahlia#credit_note_preview_lines-lines), [CreditNotePreviewParams.lines[]](/api/credit_notes/preview?api-version=2026-03-25.dahlia#preview_credit_note-lines) | #### Node.js | Parameter | Change | Resources or methods | | --- | --- | --- | | `metadata` | Added | [CreditNoteCreateParams.lines[]](/api/credit_notes/create?api-version=2026-03-25.dahlia#create_credit_note-lines), [CreditNoteLineItem](/api/credit_notes/line_item?api-version=2026-03-25.dahlia), [CreditNotePreviewLinesParams.lines[]](/api/credit_notes/preview_lines?api-version=2026-03-25.dahlia#credit_note_preview_lines-lines), [CreditNotePreviewParams.lines[]](/api/credit_notes/preview?api-version=2026-03-25.dahlia#preview_credit_note-lines) | #### Go | Parameter | Change | Resources or methods | | --- | --- | --- | | `Metadata` | Added | [CreditNoteLineItem](/api/credit_notes/line_item?api-version=2026-03-25.dahlia), [CreditNoteLineParams](/api/credit_notes/create?api-version=2026-03-25.dahlia#create_credit_note-lines), [CreditNotePreviewLineParams](/api/credit_notes/preview?api-version=2026-03-25.dahlia#preview_credit_note-lines), [CreditNotePreviewLinesLineParams](/api/credit_notes/preview_lines?api-version=2026-03-25.dahlia#credit_note_preview_lines-lines) | #### .NET | Parameter | Change | Resources or methods | | --- | --- | --- | | `Metadata` | Added | [CreditNoteLineItem](/api/credit_notes/line_item?api-version=2026-03-25.dahlia), [CreditNoteLineOptions](/api/credit_notes/create?api-version=2026-03-25.dahlia#create_credit_note-lines) | ## アップグレード #### REST API 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 2. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。 - SDK を使用していない場合は、`Stripe-Version: 2026-03-25.dahlia` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。 3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 6. 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)。 2. Ruby SDK を 最新バージョンにアップグレードします。 3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 6. 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)。 2. Python SDK を 最新バージョンにアップグレードします。 3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 6. 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)。 2. PHP SDK を 最新バージョンにアップグレードします。 3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 6. 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)。 2. Java SDK を 最新バージョンにアップグレードします。 3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 6. 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)。 2. Node SDK を 最新バージョンにアップグレードします。 3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 6. 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)。 2. Go SDK を 最新バージョンにアップグレードします。 3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 6. 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)。 2. .NET SDK を 最新バージョンにアップグレードします。 3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 6. 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)について、詳細をご確認ください。