# Ajout de l’API Orchestrated Commerce Agreements pour gérer les relations avec les intégrations de commerce agentique ## Nouveautés Ajoute l’API Orchestrated Commerce Agreements (OCA) afin de vous aider à gérer les relations avec d’autres entreprises pour les intégrations de commerce agentique. Vous pouvez utiliser l’API [Agreements](https://docs.stripe.com/api/v2/orchestrated-commerce/agreements.md?api-version=2026-04-22.preview) pour créer, confirmer, répertorier, récupérer et résilier les accords par voie programmatique. Cette API inclue également des événements webhook qui vous avertissent lorsqu’un contrat change d’état, notamment : `created`, `partially_confirmed`, `confirmed`, ou `terminated`. ## Impact Les Orchestrated Commerce Agreements établissent les autorisations nécessaires pour émettre et traiter des [tokens de paiement partagé (SPT)](https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens.md) entre un agent et commerçant. Lorsqu’un agent émet son premier SPT à un marchand, Stripe crée et confirme automatiquement un accord pour le compte de l’agent. Le traitement d’un paiement avec le SPT confirme l’accord pour le compte du commerçant. Pour établir des accords manuellement, utilisez la méthode de `création` pour initier un accord et la méthode de `confirmation` pour le finaliser. Chaque partie peut résilier l’accord à tout moment pour révoquer l’accès. Configurez des endpoints webhook pour écouter les événements de changement d’état de l’accord (`créés`, `confirmés`, `partiellement_confirmés`, `terminés`) afin que votre formulaire d’inscription puisse répondre automatiquement aux mises à jour de l’accord et déclencher les workflows d’entreprise applicables dans votre système. ## Modifications #### API REST | | Change | Resource | | --- | --- | --- | | | Added | [V2.OrchestratedCommerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | Endpoints | Change | Resource | | --- | --- | --- | | `confirm`, `create`, `list`, `retrieve`, `terminate` | Added | [V2.OrchestratedCommerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | | Change | Event type | | --- | --- | --- | | `V2OrchestratedCommerceAgreementConfirmedEvent`, `V2OrchestratedCommerceAgreementCreatedEvent`, `V2OrchestratedCommerceAgreementPartiallyConfirmedEvent`, `V2OrchestratedCommerceAgreementTerminatedEvent` | Added | `V2.OrchestratedCommerce.Agreement` | #### Ruby | | Change | Resource | | --- | --- | --- | | | Added | [V2::OrchestratedCommerce::Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | Methods | Change | Resource | | --- | --- | --- | | `confirm`, `create`, `list`, `retrieve`, `terminate` | Added | [V2::OrchestratedCommerce::Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | | Change | Event type | | --- | --- | --- | | `V2OrchestratedCommerceAgreementConfirmedEvent`, `V2OrchestratedCommerceAgreementCreatedEvent`, `V2OrchestratedCommerceAgreementPartiallyConfirmedEvent`, `V2OrchestratedCommerceAgreementTerminatedEvent` | Added | `V2::OrchestratedCommerce::Agreement` | #### Python | | Change | Resource | | --- | --- | --- | | | Added | [v2.orchestrated_commerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | Methods | Change | Resource | | --- | --- | --- | | `confirm`, `create`, `list`, `retrieve`, `terminate` | Added | [v2.orchestrated_commerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | | Change | Event type | | --- | --- | --- | | `V2OrchestratedCommerceAgreementConfirmedEvent`, `V2OrchestratedCommerceAgreementCreatedEvent`, `V2OrchestratedCommerceAgreementPartiallyConfirmedEvent`, `V2OrchestratedCommerceAgreementTerminatedEvent` | Added | `v2.orchestrated_commerce.Agreement` | #### PHP | | Change | Resource | | --- | --- | --- | | | Added | [V2.OrchestratedCommerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | Methods | Change | Resource | | --- | --- | --- | | `all`, `confirm`, `create`, `retrieve`, `terminate` | Added | [V2.OrchestratedCommerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | | Change | Event type | | --- | --- | --- | | `V2OrchestratedCommerceAgreementConfirmedEvent`, `V2OrchestratedCommerceAgreementCreatedEvent`, `V2OrchestratedCommerceAgreementPartiallyConfirmedEvent`, `V2OrchestratedCommerceAgreementTerminatedEvent` | Added | `V2.OrchestratedCommerce.Agreement` | #### Java | | Change | Resource | | --- | --- | --- | | | Added | [v2.orchestratedcommerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | Methods | Change | Resource | | --- | --- | --- | | `confirm`, `create`, `list`, `retrieve`, `terminate` | Added | [v2.orchestratedcommerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | | Change | Event type | | --- | --- | --- | | `V2OrchestratedCommerceAgreementConfirmedEvent`, `V2OrchestratedCommerceAgreementCreatedEvent`, `V2OrchestratedCommerceAgreementPartiallyConfirmedEvent`, `V2OrchestratedCommerceAgreementTerminatedEvent` | Added | `v2.orchestratedcommerce.Agreement` | #### Node.js | | Change | Resource | | --- | --- | --- | | | Added | [V2.OrchestratedCommerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | Methods | Change | Resource | | --- | --- | --- | | `confirm`, `create`, `list`, `retrieve`, `terminate` | Added | [V2.OrchestratedCommerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | | Change | Event type | | --- | --- | --- | | `V2OrchestratedCommerceAgreementConfirmedEvent`, `V2OrchestratedCommerceAgreementCreatedEvent`, `V2OrchestratedCommerceAgreementPartiallyConfirmedEvent`, `V2OrchestratedCommerceAgreementTerminatedEvent` | Added | `V2.OrchestratedCommerce.Agreement` | #### Go | | Change | Resource | | --- | --- | --- | | | Added | [V2OrchestratedCommerceAgreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | Methods | Change | Resource | | --- | --- | --- | | `Confirm`, `Get`, `List`, `New`, `Terminate` | Added | [V2OrchestratedCommerceAgreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | | Change | Event type | | --- | --- | --- | | `V2OrchestratedCommerceAgreementConfirmedEvent`, `V2OrchestratedCommerceAgreementCreatedEvent`, `V2OrchestratedCommerceAgreementPartiallyConfirmedEvent`, `V2OrchestratedCommerceAgreementTerminatedEvent` | Added | `V2OrchestratedCommerceAgreement` | #### .NET | | Change | Resource | | --- | --- | --- | | | Added | [V2.OrchestratedCommerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | Methods | Change | Resource | | --- | --- | --- | | `Confirm`, `Create`, `Get`, `List`, `Terminate` | Added | [V2.OrchestratedCommerce.Agreement](/api/v2/orchestrated-commerce/agreements?api-version=2026-04-22.preview) | | | Change | Event type | | --- | --- | --- | | `V2OrchestratedCommerceAgreementConfirmedEvent`, `V2OrchestratedCommerceAgreementCreatedEvent`, `V2OrchestratedCommerceAgreementPartiallyConfirmedEvent`, `V2OrchestratedCommerceAgreementTerminatedEvent` | Added | `V2.OrchestratedCommerce.Agreement` | ## 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-04-22.preview` 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). ## Modifications associées - [Ajoute le token Shared Payment Granted pour la gestion des moyens de paiement partagés par les agents](https://docs.stripe.com/changelog/dahlia/2026-04-22/shared-payment-granted-token.md) - [Ajout de la ressource SharedPaymentIssuedToken pour permettre aux agents de donner aux commerçants un accès étendu aux identifiants d’un client](https://docs.stripe.com/changelog/dahlia/2026-04-22/shared-payment-issued-token.md)