# Ajoute la prise en charge de l’exécution des opérations API par lots

## Nouveautés

Ajout de la possibilité de créer, traiter et suivre de grands lots asynchrones d’opérations API grâce à la nouvelle [API Batch Jobs v2 ](https://docs.stripe.com/api/v2/core/batch-jobs.md?api-version=2026-03-25.preview).

## Impact

Vous pouvez désormais créer des lots d’appels à l’API pour les exécuter de manière asynchrone. Cela vous aide à gérer efficacement les opérations de grande ampleur et à traiter des opérations groupées, comme la création de plusieurs clients, la migration d’abonnements ou la mise à jour de grands ensembles de données.

L’API Batch Jobs intègre la gestion des erreurs et le suivi de la progression à travers les événements webhook. Pour plus de détails sur son fonctionnement et les ressources qu’elle prend en charge, consultez [Batch jobs](https://docs.stripe.com/api/v2/core/batch-jobs.md?api-version=2026-03-25.preview).

## Modifications

#### API REST

|  | Change | Resource                                                                   |
|  | ------ | -------------------------------------------------------------------------- |
|  | Added  | [V2.Core.BatchJob](/api/v2/core/batch-jobs?api-version=2026-03-25.preview) |

| Endpoints                      | Change | Resource                                                                          |
| ------------------------------ | ------ | --------------------------------------------------------------------------------- |
| `cancel`, `create`, `retrieve` | Added  | [V2.Core.BatchJob](/api/v2/core/batch-jobs/cancel?api-version=2026-03-25.preview) |

|                                                                                                                                                                                                                                                                                                                                            | Change | Event type         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ------------------ |
| `V2CoreBatchJobBatchFailedEvent`, `V2CoreBatchJobCanceledEvent`, `V2CoreBatchJobCompletedEvent`, `V2CoreBatchJobCreatedEvent`, `V2CoreBatchJobReadyForUploadEvent`, `V2CoreBatchJobTimeoutEvent`, `V2CoreBatchJobUpdatedEvent`, `V2CoreBatchJobUploadTimeoutEvent`, `V2CoreBatchJobValidatingEvent`, `V2CoreBatchJobValidationFailedEvent` | Added  | `V2.Core.BatchJob` |

#### Ruby

|  | Change | Resource                                                                     |
|  | ------ | ---------------------------------------------------------------------------- |
|  | Added  | [V2::Core::BatchJob](/api/v2/core/batch-jobs?api-version=2026-03-25.preview) |

| Methods                        | Change | Resource                                                                            |
| ------------------------------ | ------ | ----------------------------------------------------------------------------------- |
| `cancel`, `create`, `retrieve` | Added  | [V2::Core::BatchJob](/api/v2/core/batch-jobs/cancel?api-version=2026-03-25.preview) |

|                                                                                                                                                                                                                                                                                                                                            | Change | Event type           |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | -------------------- |
| `V2CoreBatchJobBatchFailedEvent`, `V2CoreBatchJobCanceledEvent`, `V2CoreBatchJobCompletedEvent`, `V2CoreBatchJobCreatedEvent`, `V2CoreBatchJobReadyForUploadEvent`, `V2CoreBatchJobTimeoutEvent`, `V2CoreBatchJobUpdatedEvent`, `V2CoreBatchJobUploadTimeoutEvent`, `V2CoreBatchJobValidatingEvent`, `V2CoreBatchJobValidationFailedEvent` | Added  | `V2::Core::BatchJob` |

#### Python

|  | Change | Resource                                                                   |
|  | ------ | -------------------------------------------------------------------------- |
|  | Added  | [v2.core.BatchJob](/api/v2/core/batch-jobs?api-version=2026-03-25.preview) |

| Methods                        | Change | Resource                                                                          |
| ------------------------------ | ------ | --------------------------------------------------------------------------------- |
| `cancel`, `create`, `retrieve` | Added  | [v2.core.BatchJob](/api/v2/core/batch-jobs/cancel?api-version=2026-03-25.preview) |

|                                                                                                                                                                                                                                                                                                                                            | Change | Event type         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ------------------ |
| `V2CoreBatchJobBatchFailedEvent`, `V2CoreBatchJobCanceledEvent`, `V2CoreBatchJobCompletedEvent`, `V2CoreBatchJobCreatedEvent`, `V2CoreBatchJobReadyForUploadEvent`, `V2CoreBatchJobTimeoutEvent`, `V2CoreBatchJobUpdatedEvent`, `V2CoreBatchJobUploadTimeoutEvent`, `V2CoreBatchJobValidatingEvent`, `V2CoreBatchJobValidationFailedEvent` | Added  | `v2.core.BatchJob` |

#### PHP

|  | Change | Resource                                                                   |
|  | ------ | -------------------------------------------------------------------------- |
|  | Added  | [V2.Core.BatchJob](/api/v2/core/batch-jobs?api-version=2026-03-25.preview) |

| Methods                        | Change | Resource                                                                          |
| ------------------------------ | ------ | --------------------------------------------------------------------------------- |
| `cancel`, `create`, `retrieve` | Added  | [V2.Core.BatchJob](/api/v2/core/batch-jobs/cancel?api-version=2026-03-25.preview) |

|                                                                                                                                                                                                                                                                                                                                            | Change | Event type         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ------------------ |
| `V2CoreBatchJobBatchFailedEvent`, `V2CoreBatchJobCanceledEvent`, `V2CoreBatchJobCompletedEvent`, `V2CoreBatchJobCreatedEvent`, `V2CoreBatchJobReadyForUploadEvent`, `V2CoreBatchJobTimeoutEvent`, `V2CoreBatchJobUpdatedEvent`, `V2CoreBatchJobUploadTimeoutEvent`, `V2CoreBatchJobValidatingEvent`, `V2CoreBatchJobValidationFailedEvent` | Added  | `V2.Core.BatchJob` |

#### Java

|  | Change | Resource                                                                   |
|  | ------ | -------------------------------------------------------------------------- |
|  | Added  | [v2.core.BatchJob](/api/v2/core/batch-jobs?api-version=2026-03-25.preview) |

| Methods                        | Change | Resource                                                                          |
| ------------------------------ | ------ | --------------------------------------------------------------------------------- |
| `cancel`, `create`, `retrieve` | Added  | [v2.core.BatchJob](/api/v2/core/batch-jobs/cancel?api-version=2026-03-25.preview) |

|                                                                                                                                                                                                                                                                                                                                            | Change | Event type         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ------------------ |
| `V2CoreBatchJobBatchFailedEvent`, `V2CoreBatchJobCanceledEvent`, `V2CoreBatchJobCompletedEvent`, `V2CoreBatchJobCreatedEvent`, `V2CoreBatchJobReadyForUploadEvent`, `V2CoreBatchJobTimeoutEvent`, `V2CoreBatchJobUpdatedEvent`, `V2CoreBatchJobUploadTimeoutEvent`, `V2CoreBatchJobValidatingEvent`, `V2CoreBatchJobValidationFailedEvent` | Added  | `v2.core.BatchJob` |

#### Node.js

|  | Change | Resource                                                                   |
|  | ------ | -------------------------------------------------------------------------- |
|  | Added  | [V2.Core.BatchJob](/api/v2/core/batch-jobs?api-version=2026-03-25.preview) |

| Methods                        | Change | Resource                                                                          |
| ------------------------------ | ------ | --------------------------------------------------------------------------------- |
| `cancel`, `create`, `retrieve` | Added  | [V2.Core.BatchJob](/api/v2/core/batch-jobs/cancel?api-version=2026-03-25.preview) |

|                                                                                                                                                                                                                                                                                                                                            | Change | Event type         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ------------------ |
| `V2CoreBatchJobBatchFailedEvent`, `V2CoreBatchJobCanceledEvent`, `V2CoreBatchJobCompletedEvent`, `V2CoreBatchJobCreatedEvent`, `V2CoreBatchJobReadyForUploadEvent`, `V2CoreBatchJobTimeoutEvent`, `V2CoreBatchJobUpdatedEvent`, `V2CoreBatchJobUploadTimeoutEvent`, `V2CoreBatchJobValidatingEvent`, `V2CoreBatchJobValidationFailedEvent` | Added  | `V2.Core.BatchJob` |

#### Go

|  | Change | Resource                                                                 |
|  | ------ | ------------------------------------------------------------------------ |
|  | Added  | [V2CoreBatchJob](/api/v2/core/batch-jobs?api-version=2026-03-25.preview) |

| Methods                | Change | Resource                                                                        |
| ---------------------- | ------ | ------------------------------------------------------------------------------- |
| `Cancel`, `Get`, `New` | Added  | [V2CoreBatchJob](/api/v2/core/batch-jobs/cancel?api-version=2026-03-25.preview) |

|                                                                                                                                                                                                                                                                                                                                            | Change | Event type       |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------- |
| `V2CoreBatchJobBatchFailedEvent`, `V2CoreBatchJobCanceledEvent`, `V2CoreBatchJobCompletedEvent`, `V2CoreBatchJobCreatedEvent`, `V2CoreBatchJobReadyForUploadEvent`, `V2CoreBatchJobTimeoutEvent`, `V2CoreBatchJobUpdatedEvent`, `V2CoreBatchJobUploadTimeoutEvent`, `V2CoreBatchJobValidatingEvent`, `V2CoreBatchJobValidationFailedEvent` | Added  | `V2CoreBatchJob` |

#### .NET

|  | Change | Resource                                                                   |
|  | ------ | -------------------------------------------------------------------------- |
|  | Added  | [V2.Core.BatchJob](/api/v2/core/batch-jobs?api-version=2026-03-25.preview) |

| Methods                   | Change | Resource                                                                          |
| ------------------------- | ------ | --------------------------------------------------------------------------------- |
| `Cancel`, `Create`, `Get` | Added  | [V2.Core.BatchJob](/api/v2/core/batch-jobs/cancel?api-version=2026-03-25.preview) |

|                                                                                                                                                                                                                                                                                                                                            | Change | Event type         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ------------------ |
| `V2CoreBatchJobBatchFailedEvent`, `V2CoreBatchJobCanceledEvent`, `V2CoreBatchJobCompletedEvent`, `V2CoreBatchJobCreatedEvent`, `V2CoreBatchJobReadyForUploadEvent`, `V2CoreBatchJobTimeoutEvent`, `V2CoreBatchJobUpdatedEvent`, `V2CoreBatchJobUploadTimeoutEvent`, `V2CoreBatchJobValidatingEvent`, `V2CoreBatchJobValidationFailedEvent` | Added  | `V2.Core.BatchJob` |

## 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-03-25.preview`
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).