# Ajout de l’API Product Catalog Import v2

## Nouveautés

Ajout de l’[API Product Catalog Import v2](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia) pour l’importation des données catalogue de produits via des fichiers CSV. Vous pouvez désormais créer, récupérer et lister les importations de catalogues produits à l’aide de la nouvelle ressource [ProductCatalogImport](https://docs.stripe.com/api/v2/commerce/product-catalog-imports/object.md?api-version=2026-04-22.dahlia).

L’API prend en charge les fichiers CSV allant jusqu’à 4 Go et propose un processus d’importation en une seule étape pour différents types de flux. Après avoir créé une importation, vous pouvez suivre sa progression grâce à des événements webhook, notamment :

- [v2.commerce.product_catalog.imports.processing](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-v2.commerce.product_catalog.imports.processing) Envoyé à la réception du fichier et au début du traitement
- [v2.commerce.product_catalog.imports.succeeded](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-v2.commerce.product_catalog.imports.succeeded) Envoyé lorsque l’importation se termine sans erreur de validation
- [v2.commerce.product_catalog.imports.succeeded_with_errors](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-v2.commerce.product_catalog.imports.succeeded_with_errors) Envoyé lorsque l’importation est terminée mais comporte des erreurs de validation
- [v2.commerce.product_catalog.imports.failed](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-v2.commerce.product_catalog.imports.failed) Envoyé lorsque l’importation ne peut pas terminer le traitement

## Impact

Vous pouvez désormais importer par voie programmatique des catalogues de produits volumineux sans avoir à fractionner votre catalogue ni à effectuer plusieurs appels d’API distincts. Cela permet de réduire le temps et les étapes nécessaires à la mise en place de catalogues de produits pour des stocks volumineux, que ce soit lors de la configuration initiale ou des mises à jour en masse.

Les événements webhook vous permettent de créer des workflows automatisés qui réagissent à la fin de l’importation, vous permettant ainsi de déclencher des processus en aval, tels que la synchronisation des stocks ou la validation du catalogue une fois l’importation terminée.

Pour en savoir plus, consultez [Vendre via des agents](https://docs.stripe.com/agentic-commerce/for-sellers.md?order-monitoring=webhooks&dashboard-or-api=api#upload-feed).

## Modifications

#### API REST

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Endpoints                    | Change | Resource                                                                                                                                           |
| ---------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve`, `list` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

#### Ruby

|  | Change | Resource                                                                                                                                             |
|  | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2::Commerce::ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                             |
| -------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2::Commerce::ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                           |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------ |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2::Commerce::ProductCatalogImport` |

#### Python

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `v2.commerce.ProductCatalogImport` |

#### PHP

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

#### Java

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `v2.commerce.ProductCatalogImport` |

#### Node.js

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

#### Go

|  | Change | Resource                                                                                                                                         |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
|  | Added  | [V2CommerceProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods      | Change | Resource                                                                                                                                         |
| ------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Get`, `New` | Added  | [V2CommerceProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                       |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2CommerceProductCatalogImport` |

#### .NET

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods         | Change | Resource                                                                                                                                           |
| --------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Create`, `Get` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

## 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.
1. 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-04-22.dahlia`
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [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.
1. Mettez à niveau votre SDK Ruby vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [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.
1. Mettez à niveau votre SDK Python vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [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.
1. Mettez à niveau votre SDK PHP vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [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.
1. Mettez à niveau votre SDK Java vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [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.
1. Mettez à niveau votre SDK Node vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [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.
1. Mettez à niveau votre SDK Go vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [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.
1. Mettez à niveau votre SDK .NET vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [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).