# 入金の追跡 ID

銀行を介して入金の遅延または入金漏れを追跡します。

追跡 IDは、銀行パートナーが作成する入金の一意の識別子で、入金の漏れや遅延を追跡するのに役立ちます。予定されている入金が 10 営業日経っても銀行口座に振り込まれない場合は、銀行に連絡して最新の情報を入手し、追跡 ID を提供してください。追跡 IDは、[Stripe ダッシュボード](https://dashboard.stripe.com/test/payouts)、[API](https://docs.stripe.com/api/payouts/retrieve.md)、[Sigma](https://docs.stripe.com/stripe-data.md)、[入金照合レポート](https://docs.stripe.com/reports/payout-reconciliation.md)でご確認いただけます。

Connect ユーザーの場合、[Stripe API](https://docs.stripe.com/api/payouts/retrieve.md) で 追跡 ID を確認することで、連結アカウントに追跡 ID を提供できます。これにより、人力サポートを介入させることなく、連結アカウントが入金の遅延や入金漏れを自ら調査できるようになります。

これにより、Connect ユーザーは以下のメリットを得られます。

- 入金の遅延または入金漏れに伴う、連結アカウントからのサポートリクエストが最小限に抑えられます。
- 連結アカウントが入金の遅延または入金漏れの調査を銀行と一緒にセルフサービスで行えるようになり、ユーザー満足度が向上します。

> #### 追跡 ID の形式
> 
> 追跡 ID の形式は Stripe の各銀行パートナーで異なるため、入金ごとに統一されていない場合があります。

## サポート状況

追跡 ID は、入金が支払い済みとしてマークされてから最大 10 日後にパートナー銀行によって取得されます。追跡 ID はこの期間中、利用できないことがあります。その場合、追跡 ID のステータスは保留中としてマークされます。10 日経過しても追跡 ID を取得できない場合、その追跡 ID はサポート対象外としてマークされます。

## ダッシュボード

ダッシュボードで追跡 ID にアクセスするには、以下の手順に従います。

1. [入金](https://dashboard.stripe.com/test/payouts) に移動します。
1. 調査する入金をクリックします。
1. 追跡 ID は「詳細」セクションで確認できます。

## API

API の仕様は、Stripe API ドキュメントでご確認いただけます。

`trace_id` には、`value` と `status` の 2 つのサブフィールドがあります。

- `value`: 入金が行われる際に銀行パートナーから取得する追跡 ID の文字列。
- `ステータス`: 銀行パートナーから取得中の追跡 ID の現在のステータス。

| ステータス         | 説明                                                                                                      |
| ------------- | ------------------------------------------------------------------------------------------------------- |
| `pending`     | 入金が支払い済みとしてマークされると、Stripe は最長 10 日間、銀行パートナーから追跡 ID の取得を試みます。この間、`status` は `pending` になります。             |
| `supported`   | 追跡 ID が銀行パートナーから正常に取得されると、`status` が `supported` になります。`value` はこの時点で表示されます。                            |
| `unsupported` | 入金に失敗したり、国と通貨の組み合わせがサポートされていないなど、追跡 ID を提供できないシナリオが発生することがあります。このような場合、 `status` が `unsupported` になります。 |

### API で追跡 ID を取得する

```curl
curl https://api.stripe.com/v1/payouts/po_xxx \
  -u "<<YOUR_SECRET_KEY>>:"
```

#### Json

```json
{
  "object": "list",
  "data": [
    {
      "id": "po_xxx",
      "trace_id": {
        "status": "supported",
        "value": "7UF6L35ME6bh3bk3cj51L7o93ky79X5Pb58i5LO1e"
      }
      ...
    }
  ]
}
```

## Sigma

追跡 ID には、Sigma を使用してアクセスすることもできます。次のクエリ例では、送金テーブルを使用して、直近の 3 つの入金の追跡 ID 情報を取得します。

#### SQL

```sql
select
  date_format(created, '%m/%d/%Y') as day,
  id,
  trace_id_status,
  trace_id
from transfers
order by day desc
limit 3
```

| `day`          | `id`                        | `trace_id_status` | `trace_id`                |
| -------------- | --------------------------- | ----------------- | ------------------------- |
| 2024 年 9 月 9 日 | po_orWziM4j7CiRL8J4vQmXgW2w | 保留中               | null                      |
| 2024 年 9 月 8 日 | po_orWziM4j7CiRL8J4vQmXgW2w | サポート対象            | orWziM4j7CiRL8J4vQmXgW2w5 |
| 2024 年 9 月 6 日 | po_orWziM4j7CiRL8J4vQmXgW2w | サポート対象外           | null                      |

## サポート

追跡 ID は、以下の入金先を除き、Stripe がサポートするすべての国で利用できます。

- アルゼンチン
- ボリビア
- チリ
- コロンビア
- エジプト
- 日本
- フィリピン
- イギリス (Instant Payouts)