# Checkout セッションで配送情報が削除されます

## 新規情報

[Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md?api-version=2025-03-31.basil) では、最上位フィールドの `shipping_details` が [collected_information.shipping_details](https://docs.stripe.com/api/checkout/sessions/object.md?api-version=2025-03-31.basil#checkout_session_object-collected_information-shipping_details) フィールドに移動しました。

## この変更により互換性が失われる理由

同じ Checkout Session リソースの `shipping_details` フィールドが [collected_information](https://docs.stripe.com/api/checkout/sessions/object.md?api-version=2025-03-31.basil#checkout_session_object-collected_information-shipping_details) サブハッシュに移動するため、この変更により互換性がなくなります。新しいフィールド名を反映するように実装を更新します。

## 効果

この変更は、Checkout Session リソースの配送情報にアクセスする方法に影響します。API リソースの構成方法が改善され、関連情報がより論理的にグループ化されます。配送の詳細を `collected_information` オブジェクトに移動すると、顧客が決済プロセスの一環としてこの情報を提供したことが明確になります。

この変更を採用するには、次の手順を実行します。

1. Checkout Session リソースに接続するコードを確認します。
2. `shipping_details` フィールドにアクセスしているインスタンスを特定します。
3. 代わりに `collected_information['shipping_details']` を使用するようにこれらのインスタンスを更新します。

## 変更点

#### REST API

| Parameter | Change | Resources or endpoints |
| --- | --- | --- |
| `shipping_details` | Removed | [Checkout.Session](/api/checkout/sessions/object?api-version=2025-03-31.basil) |

#### Ruby

この変更は、Ruby SDK には影響しません。

#### Python

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `shipping_details` | Removed | [stripe.checkout.Session](/api/checkout/sessions/object?api-version=2025-03-31.basil) |

#### PHP

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `shipping_details` | Removed | [Checkout.Session](/api/checkout/sessions/object?api-version=2025-03-31.basil) |

#### Java

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `shipping_details` | Removed | [Checkout.Session](/api/checkout/sessions/object?api-version=2025-03-31.basil) |

#### Node.js

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `shipping_details` | Removed | [Checkout.Session](/api/checkout/sessions/object?api-version=2025-03-31.basil) |

#### Go

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `ShippingDetails` | Removed | [CheckoutSession](/api/checkout/sessions/object?api-version=2025-03-31.basil) |

#### .NET

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `ShippingDetails` | Removed | [CheckoutSession](/api/checkout/sessions/object?api-version=2025-03-31.basil) |

## アップグレード

#### 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: 2025-03-31.basil` を含めるように [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 を [v15.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.0.0)にアップグレードします。
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 を [v12.0.0](https://github.com/stripe/stripe-python/releases/tag/v12.0.0)にアップグレードします。
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 を [v17.0.0](https://github.com/stripe/stripe-php/releases/tag/v17.0.0)にアップグレードします。
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 を [v29.0.0](https://github.com/stripe/stripe-java/releases/tag/v29.0.0)にアップグレードします。
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 を [v18.0.0](https://github.com/stripe/stripe-node/releases/tag/v18.0.0)にアップグレードします。
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 を [v82.0.0](https://github.com/stripe/stripe-go/releases/tag/v82.0.0)にアップグレードします。
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 を [v48.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.0.0)にアップグレードします。
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)について、詳細をご確認ください。

## 関連する変更点

- [Checkout Sessions のレイテンシーが低く、更新セマンティクスが新しくなりました](https://docs.stripe.com/changelog/basil/2025-03-31/checkout-legacy-subscription-upgrade.md)
- [Checkout Session で配送オプションの更新が可能に](https://docs.stripe.com/changelog/basil/2025-03-31/checkout-session-shipping-options-update-param.md)
- [Checkout Sessions に permissions パラメーターを追加](https://docs.stripe.com/changelog/basil/2025-03-31/cs_add_checkout_session_permissions.md)
- [Checkout セッションと Payment Links にオプション項目を追加しました](https://docs.stripe.com/changelog/basil/2025-03-31/checkout_optional_items.md)