# エージェンティックコマース連携の関係を管理するためのオーケストレーテッドコマース契約 API を追加

## 新機能

Orchestrated Commerce Agreements (OCAs) API を追加しエージェンティックコマース連携における他の企業との関係を管理できるようにしました。[Agreements](https://docs.stripe.com/api/v2/orchestrated-commerce/agreements.md?api-version=2026-04-22.preview) API を使用すると、契約の作成、確認、一覧表示、取得、終了をプログラムで実行できます。

この API には、契約の状態が変化したときに通知する webhook イベントも含まれています。対象の状態は `created`、`partially_confirmed`、`confirmed`、`terminated` です。

## 影響

Orchestrated Commerce Agreements は、エージェントと売り手の間で [Shared Payment Tokens (SPTs)](https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens.md) を発行および処理するために必要な権限を確立します。エージェントが売り手に最初の SPT を発行すると、Stripe はエージェントに代わって契約を自動的に作成し、確認します。SPT を使用して決済を処理すると、売り手に代わって契約が確認されます。

契約を手動で確立するには、`create` メソッドを使用して契約を開始し、`confirm` メソッドを使用して確定します。どちらの当事者も、いつでも契約を終了してアクセス権を取り消すことができます。

Webhook エンドポイントを設定して、契約状態の変更イベント (`created`、`confirmed`、`partially_confirmed`、`terminated`) をリッスンすることで、アプリケーションが契約の更新に自動的に応答し、システム内の該当するビジネスワークフローをトリガーできるようになります。

## 変更点

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

## アップグレード

#### REST API

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
   - SDK を使用していない場合は、`Stripe-Version: 2026-04-22.preview` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Ruby

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Ruby SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Python

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Python SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### PHP

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. PHP SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Java

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Java SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Node.js

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Node SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Go

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Go SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### .NET

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. .NET SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

## 関連する変更

- [エージェントが共有する決済手段を管理するための Shared Payment Granted Token の追加](https://docs.stripe.com/changelog/dahlia/2026-04-22/shared-payment-granted-token.md)
- [エージェントが売り手に顧客の認証情報への限定的なアクセスを付与できるようにする SharedPaymentIssuedToken リソースを追加](https://docs.stripe.com/changelog/dahlia/2026-04-22/shared-payment-issued-token.md)