# Fügt die Orchestrated Commerce Agreements API hinzu, um Beziehungen für Agentic-Commerce-Integrationen zu verwalten ## Das ändert sich Fügt die Orchestrated Commerce Agreements (OCAs) API hinzu, um Sie bei der Verwaltung von Beziehungen zu anderen Unternehmen im Rahmen von Agentic-Commerce-Integrationen zu unterstützen. Mithilfe der [Agreements](https://docs.stripe.com/api/v2/orchestrated-commerce/agreements.md?api-version=2026-04-22.preview) API können Sie Vereinbarungen programmgesteuert erstellen, bestätigen, auflisten, abrufen und kündigen. Diese API umfasst auch Webhook-Ereignisse, die Sie benachrichtigen, wenn sich der Status einer Vereinbarung ändert, darunter: `created`, `partially_confirmed`, `confirmed` oder `terminated`. ## Auswirkungen Orchestrated Commerce Agreements legt die erforderlichen Berechtigungen für die Ausstellung und Verarbeitung von [Shared Payment Tokens (SPTs)](https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens.md) zwischen einem Agenten und einer/einem Verkäufer/in fest. Wenn ein Agent sein erstes SPT an eine/n Verkäufer/in ausstellt, erstellt und bestätigt Stripe automatisch eine Vereinbarung im Namen des Agenten. Die Abwicklung einer Zahlung mit dem SPT bestätigt die Vereinbarung im Namen der/des Verkäuferin/Verkäufers. Um Vereinbarungen manuell anzulegen, verwenden Sie die Methode `create`, um eine Vereinbarung zu initiieren, und die Methode `confirm`, um sie abzuschließen. Jede der Parteien kann die Vereinbarung jederzeit kündigen, um den Zugriff zu widerrufen. Richten Sie Webhook-Endpoints ein, um auf Ereignisse zu Änderungen des Vertragsstatus (`created`, `confirmed`, `partially_confirmed`, `terminated`) zu reagieren, damit Ihre Anwendung automatisch auf Vertragsaktualisierungen reagieren und die entsprechenden Geschäftsabläufe in Ihrem System auslösen kann. ## Änderungen #### REST API | | 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` | ## 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. 2. 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.preview` 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Aktualisieren Sie Ihr Ruby SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Aktualisieren Sie Ihr Python SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Aktualisieren Sie Ihr PHP SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Aktualisieren Sie Ihr Java SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Aktualisieren Sie Ihr Node SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Aktualisieren Sie Ihr Go SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Aktualisieren Sie Ihr .NET SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. 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). ## Zugehörige Änderungen - [Fügt den für die gemeinsame Zahlung gewährten Token für die Verwaltung von Zahlungsmethoden hinzu, die von Agenten gemeinsam genutzt werden](https://docs.stripe.com/changelog/dahlia/2026-04-22/shared-payment-granted-token.md) - [Fügt die Ressource „SharedPaymentIssuedToken“ hinzu, damit Agenten Verkäuferinnen und Verkäufern einen umfassenden Zugriff auf die Kundenanmeldedaten gewähren können](https://docs.stripe.com/changelog/dahlia/2026-04-22/shared-payment-issued-token.md)