# 一意の ID を使用して入金を追跡する ## 新機能 [入金](https://docs.stripe.com/api/payouts.md?api-version=2024-11-20.acacia)リソースに [trace_id](https://docs.stripe.com/api/payouts/object.md?api-version=2024-11-20.acacia#payout_object-trace_id) フィールドを導入します。 [追跡 ID](https://docs.stripe.com/payouts/trace-id.md) は、銀行パートナーが作成する入金の一意の識別子で、入金の漏れや遅延を追跡するのに役立ちます。予定されている入金が 10 営業日経っても銀行口座に振り込まれない場合は、銀行に連絡して最新の情報を入手し、追跡 ID を提供してください。 For Connect users, you can provide your connected accounts their payout trace IDs by [retrieving them from the Stripe API](https://docs.stripe.com/api/payouts/retrieve.md?api-version=2024-11-20.acacia). これにより、人力サポートを介入させることなく、連結アカウントが入金の遅延や入金漏れを自ら調査できるようになります。 `trace_id` には、[value](https://docs.stripe.com/api/payouts/object.md?api-version=2024-11-20.acacia#payout_object-trace_id-value) と [status](https://docs.stripe.com/api/payouts/object.md?api-version=2024-11-20.acacia#payout_object-trace_id-status) の 2 つのサブフィールドがあります。 - `value`: 入金が行われた際に銀行パートナーから取得する追跡 ID の文字列。 - `status`: 銀行パートナーから取得した追跡 ID の現在のステータス。 | ステータス | 概要 | | ------------- | ------------------------------------------------------------------------------------------------------- | | `pending` | お客様が入金を支払い済みとしてマークした後、Stripe は最長 10 日間、銀行パートナーから追跡 ID の取得を試みます。この間、`status` は `pending` になります。 | | `supported` | 銀行パートナーが追跡 ID を提供すると、`status` が `supported` になり、Stripe は `value` を更新します。 | | `unsupported` | 入金に失敗したり、国と通貨の組み合わせがサポートされていないなど、追跡 ID を提供できないシナリオが発生することがあります。このような場合、 `status` が `unsupported` になります。 | ## 影響 特定の入金の追跡 ID は、[入金を取得](https://docs.stripe.com/api/payouts/retrieve.md?api-version=2024-11-20.acacia)することで取得できます。 Connect ユーザーの場合、連結アカウントに追跡 ID を提供することで、以下のメリットが得られます。 - 入金の遅延または入金漏れに伴う、連結アカウントからのサポートリクエストが最小限に抑えられます。 - 連結アカウントが入金の遅延または入金漏れの調査を銀行と一緒にセルフサービスで行えるようになり、ユーザー満足度が向上します。 ## 変更点 #### REST API | Parameter | Change | Resources or endpoints | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Ruby この変更は、Ruby SDK には影響しません。 #### Python | Parameter | Change | Resources or methods | | ---------- | ------ | ------------------------------------------------------------------ | | `trace_id` | Added | [stripe.Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### PHP | Parameter | Change | Resources or methods | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Java | Parameter | Change | Resources or methods | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Node.js | Parameter | Change | Resources or methods | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Go | Parameter | Change | Resources or methods | | --------- | ------ | ----------------------------------------------------------- | | `TraceID` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### .NET | Parameter | Change | Resources or methods | | --------- | ------ | ----------------------------------------------------------- | | `TraceId` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | ## アップグレード #### REST API 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。 - SDK を使用していない場合は、`Stripe-Version: 2024-11-20.acacia` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. Ruby SDK を [v13.2.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.2.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. Python SDK を [v11.3.0](https://github.com/stripe/stripe-python/releases/tag/v11.3.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. PHP SDK を [v16.3.0](https://github.com/stripe/stripe-php/releases/tag/v16.3.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. Java SDK を [v28.1.0](https://github.com/stripe/stripe-java/releases/tag/v28.1.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. Node SDK を [v17.4.0](https://github.com/stripe/stripe-node/releases/tag/v17.4.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. Go SDK を [v81.1.0](https://github.com/stripe/stripe-go/releases/tag/v81.1.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. .NET SDK を [v47.1.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.1.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)について、詳細をご確認ください。