# Fügt die Product Catalog Import API v2 hinzu

## Das ändert sich

Fügt die [Product Catalog Import API v2](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia) zum Hochladen von Product Catalog-Daten über CSV-Dateien hinzu. Sie können nun mithilfe der neuen Ressource [ProductCatalogImport](https://docs.stripe.com/api/v2/commerce/product-catalog-imports/object.md?api-version=2026-04-22.dahlia) Product Catalog-Importe erstellen, abrufen und auflisten.

Die API unterstützt CSV-Dateien mit einer Größe von bis zu 4 GB und bietet einen einstufigen Hochladevorgang für verschiedene Feed-Typen. Nachdem Sie einen Import erstellt haben, können Sie dessen Fortschritt über Webhook-Ereignisse verfolgen, darunter:

- [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) Wird gesendet, sobald die Datei empfangen wurde und die Verarbeitung begonnen hat
- [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) Wird gesendet, sobald der Import ohne Validierungsfehler abgeschlossen ist
- [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) Wird gesendet, wenn der Import abgeschlossen ist, aber Validierungsfehler vorliegen
- [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) Wird gesendet, wenn der Import nicht abgeschlossen werden kann

## Ergebnis

Sie können nun große Produktkataloge programmgesteuert importieren, ohne Ihren Katalog aufteilen und über separate API-Aufrufe hochladen zu müssen. Dies trägt dazu bei, den Zeitaufwand und die erforderlichen Schritte bei der Einrichtung von Produktkatalogen für große Bestände zu reduzieren, sowohl bei der Ersteinrichtung als auch bei Massenaktualisierungen.

Mithilfe der Webhook-Ereignisse können Sie automatisierte Workflows erstellen, die auf den Abschluss eines Imports reagieren, sodass Sie nach Abschluss des Imports nachfolgende Abläufe wie die Bestandssynchronisierung oder die Katalogvalidierung auslösen können.

Weitere Informationen finden Sie unter [Über Agenten verkaufen](https://docs.stripe.com/agentic-commerce/for-sellers.md?order-monitoring=webhooks&dashboard-or-api=api#upload-feed).

## Änderungen

#### REST API

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

## Upgrade

#### REST API

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
   - Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre [API-Anfragen](https://docs.stripe.com/api/versioning.md) auf `Stripe-Version: 2026-04-22.dahlia`
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Ruby SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Python SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr PHP SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Java SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Node SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Go SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr .NET SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).