# Ajoute la propriété métadonnées aux éléments de ligne des avoirs

## Nouveautés

Ajoute la possibilité de joindre des paires clé-valeur à des éléments de ligne individuels en utilisant la nouvelle propriété [metadata](https://docs.stripe.com/api/credit_notes/line_item.md?api-version=2026-03-25.dahlia#credit_note_line_item_object-metadata) de l’objet [Credit Note Line Item](https://docs.stripe.com/api/credit_notes/line_item.md?api-version=2026-03-25.dahlia).

Lorsque vous [créez](https://docs.stripe.com/api/credit_notes/create.md?api-version=2026-03-25.dahlia) ou [prévisualisez](https://docs.stripe.com/api/credit_notes/preview.md?api-version=2026-03-25.dahlia) un avoir, vous pouvez désormais spécifier des [métadonnées](https://docs.stripe.com/api/credit_notes/create.md?api-version=2026-03-25.dahlia#create_credit_note-lines-metadata) pour chaque élément de ligne dans le paramètre `lines`. L’API stocke ces métadonnées dans l’objet Elément de ligne d’avoir résultant et les renvoie lorsque vous récupérez l’avoir ou ses éléments de ligne.

La propriété métadonnées peut contenir jusqu’à 50 clés, avec des noms de clés ne dépassant pas 40 caractères et des valeurs limitées à 500 caractères.

## Impact

Vous pouvez désormais joindre des informations personnalisées à chaque élément de ligne d’un avoir pour vos besoins de suivi interne, de reporting et de logique métier. Par exemple, vous pouvez utiliser les métadonnées pour stocker des codes produits internes, des informations sur les départements ou toute autre donnée spécifique à votre activité qui vous aide à catégoriser et à analyser les éléments de ligne de vos avoirs.

## Modifications

#### API REST

| 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) |

## Mise à niveau

#### API REST

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
2. Si vous utilisez un SDK, passez à une version correspondant à celle de l’API.
   - Si vous n’utilisez pas de SDK, mettez à jour vos [requêtes API](https://docs.stripe.com/api/versioning.md) pour inclure la `version Stripe : 2026-03-25.dahlia`
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
2. Mettez à niveau votre SDK Ruby vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Python

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
2. Mettez à niveau votre SDK Python vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
2. Mettez à niveau votre SDK PHP vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Java

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
2. Mettez à niveau votre SDK Java vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
2. Mettez à niveau votre SDK Node vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Go

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
2. Mettez à niveau votre SDK Go vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
2. Mettez à niveau votre SDK .NET vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).