# 連結アカウントデータのクエリ

Sigma と Data Pipeline を使用して、連結アカウント情報を取得します。

*Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients) プラットフォームでは、Sigma または Data Pipeline を使用して、連結アカウントに関するレポートを作成できます。お客様自身の Stripe アカウントで行うのとほぼ同じ方法で、プラットフォーム全体に対して実行するクエリを作成できます。

スキーマ内の Connect 固有テーブルのうち、その他のグループは、スキーマの **Connect** セクションに存在します。Connect プラットフォームを運用していない場合、これらのテーブルは表示されません。

## 連結アカウントの情報

`connected_accounts` テーブルでは、[Account (アカウント)](https://docs.stripe.com/api.md#account_object) オブジェクトのリストが提供され、連結アカウントに関する情報が含まれます。このテーブルは、プラットフォーム上のアカウント全体を対象にしたアカウントレベルの情報 ([ビジネス名](https://docs.stripe.com/api.md#account_object-business_name)、[国](https://docs.stripe.com/api.md#account_object-country)、ユーザーの[メールアドレス](https://docs.stripe.com/api.md#account_object-email)など)に使用されます。

次の例では、`connected_accounts`テーブルを使用して、アメリカ在住の個人の 5 件のアカウントのリストを取得します。これらのアカウントは、[アカウントの確認](https://docs.stripe.com/connect/identity-verification.md)に[必要な確認情報](https://docs.stripe.com/connect/required-verification-information.md)が Stripe に提供されていないという理由により、*入金* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit)が無効になっています。

```sql
  select
    id,
    email,
    legal_entity_address_city as city,
    legal_entity_address_line1 as line1,
    legal_entity_address_postal_code as zip,
    legal_entity_address_state as state,
    legal_entity_dob_day as dob_day,
    legal_entity_dob_month as dob_month,
    legal_entity_dob_year as dob_year,
    legal_entity_first_name as first_name,
    legal_entity_last_name as last_name,
    legal_entity_ssn_last_4_provided as ssn_provided,
    tos_acceptance_date as tos_date,
    tos_acceptance_ip as tos_ip,
    legal_entity_personal_id_number_provided as id_provided,
    legal_entity_verification_document_id as document_id
  from connected_accounts
  where legal_entity_type = 'individual'
    and payouts_enabled = false
    and country = 'US'
  limit 5
```

アメリカ国内の個々のアカウントの必須フィールドのすべてが列として取得されます。これにより、提供されている情報と必要な情報をアカウントごとに確認できます。以下のレポート例にこれを示します (簡潔にするため一部の列は省略されています)。

| ID            | メール                        | city     | … | id_provided | document_id   |
| ------------- | -------------------------- | -------- | - | ----------- | ------------- |
| acct_orWziM4… | kaoru.hanamura@example.com | サンフランシスコ | … | true        | file_orWziM4… |
| acct_orWziM4… | sophia.garcia@example.com  |          | … | false       | file_orWziM4… |
| acct_orWziM4… | natalie.davis@example.com  | シアトル     | … | true        | file_orWziM4… |
| acct_orWziM4… | ella.thompson@example.com  | オースティン   | … | false       | file_orWziM4… |
| acct_orWziM4… | james.smith@example.com    |          | … | false       | file_orWziM4… |

## 要件が適用されているアカウント

`connected_accounts` テーブルには、連結アカウントの `requirements` と `future_requirements` に関する情報も含まれます。このテーブルを使用して、現時点で期日に達している要件と、まもなく無効になる要件を持つアカウントのリストを取得します。`future_requirements` 列を使用して、[確認要件の更新に対応します](https://docs.stripe.com/connect/handle-verification-updates.md)。

次の例では、`connected_accounts` テーブルを使用して、確認要件の更新が予定されているアカウントのリストを取得します。

```sql
select
  id,
  business_name,
  requirements_currently_due,
  future_requirements_currently_due
from
  connected_accounts
where
  future_requirements_currently_due != ''
```

| ID                    | business_name | requirements_currently_due | future_requirements_currently_due                       |
| --------------------- | ------------- | -------------------------- | ------------------------------------------------------- |
| acct_1orWziM4j7CiRL8J | RocketRides   |                            | business_profile.url                                    |
| acct_1orWziM4j7CiRL8J | Kavholm       |                            | individual.email,settings.payments.statement_descriptor |
| acct_1orWziM4j7CiRL8J | FurEver       | external_account           | settings.payments.statement_descriptor                  |
| acct_1orWziM4j7CiRL8J | Pasha         | business_profile.url       | company.tax_id                                          |

クエリ可能な列`要件`および `future_requirements` 情報はアカウントの要件をカンマ区切られたリストで示しています。

| 要件                                  | future_requirements                        |
| ----------------------------------- | ------------------------------------------ |
| `requirements_past_due`             | `future_requirements_past_due`             |
| `requirements_currently_due`        | `future_requirements_currently_due`        |
| `requirements_eventually_due`       | `future_requirements_eventually_due`       |
| `requirements_pending_verification` | `future_requirements_pending_verification` |

## 連結アカウント用の取引データ

Sigma および Data Pipeline には、Connect プラットフォーム用のさまざまな[クエリテンプレート](https://dashboard.stripe.com/sigma/queries/templates)が含まれています。これらを使用して、連結アカウントのレポート作成を開始します。

連結アカウントの[取引](https://docs.stripe.com/stripe-data/query-transactions.md)データと[サブスクリプション](https://docs.stripe.com/stripe-data/query-billing-data.md)データは、`connected_account_` テーブルに格納されます。連結アカウントで使用可能なデータは、お客様自身のアカウントのデータと同じ方法で整理され、構造化されます。

たとえば、**Payments** セクションにある `balance_transactions` テーブルには、お客様の Stripe アカウントの取引残高データが格納されます。**Connect - Payments (支払い)** セクションにある `connected_account_balance_transactions` テーブルには、連結アカウントの取引残高データが格納されます。Connect 固有の各テーブルには、連結アカウントの ID を格納するための追加の `account` 列があります。これは、テーブルを結合して拡張クエリを作成する際に使用できます。

次の例は、エディターに読み込まれるデフォルトのクエリに基づいています。アカウントの最新 10 件の取引残高を取得する代わりに、プラットフォームの連結アカウントすべてを対象に取得します。

```sql
    select
      date_format(created, '%m-%d-%Y') as day,
      account, -- Added to include corresponding account identifier
      id,
      amount,
      currency,
      source_id,
      type
    from connected_account_balance_transactions -- Changed to use Connect-specific table
    order by day desc
    limit 5
```

| 日         | 口座            | ID           | 金額     | 通貨  | source_id   | type   |
| --------- | ------------- | ------------ | ------ | --- | ----------- | ------ |
| 2026/3/20 | acct_orWziM4… | txn_orWziM4… | -1,000 | usd | re_orWziM4… | 顧客への返金 |
| 2026/3/20 | acct_orWziM4… | txn_orWziM4… | 1,000  | usd | ch_orWziM4… | 料金     |
| 2026/3/20 | acct_orWziM4… | txn_orWziM4… | 1,000  | usd | ch_orWziM4… | 料金     |
| 2026/3/20 | acct_orWziM4… | txn_orWziM4… | 1,000  | eur | ch_orWziM4… | 料金     |
| 2026/3/20 | acct_orWziM4… | txn_orWziM4… | -1,000 | usd | re_orWziM4… | 顧客への返金 |

取引データとサブスクリプションデータのクエリに関する詳細は、Stripe の[取引](https://docs.stripe.com/stripe-data/query-transactions.md)と[サブスクリプション](https://docs.stripe.com/stripe-data/query-billing-data.md)のドキュメントを参照してください。これにより、Connect 固有の情報を用いてクエリを補足または調整し、連結アカウントのレポートを作成できるようになります。

### 連結アカウントで支払いをクエリする

Sigma または Data Pipeline を使用して、連結アカウントへの売上の流れに関するレポートを作成できます。この手順は、プラットフォームでの支払いの作成方法によって異なります。

## ダイレクト支払い

プラットフォームで連結アカウントの[ダイレクト支払い](https://docs.stripe.com/connect/direct-charges.md)を作成すると、これらの支払いはプラットフォームではなく、連結アカウントに表示されます。連結アカウントがそのアカウント上で支払いリクエストを作成するのと同様です。プラットフォームでは、Connect 固有のテーブル (`connected_account_charges`、`connected_account_balance_transactions` など) を使用してダイレクト支払いに関するレポートを作成できます。

[ダイレクト支払いクエリテンプレート](https://dashboard.stripe.com/sigma/queries/templates/Direct%20charges)にアクセスし、ダイレクト支払いで得られたプラットフォーム手数料に関する明細情報を取得し、連結アカウント、送金、および作成された支払いに関するレポートを作成できます。

## デスティネーション支払い

連結アカウントの代わりにプラットフォームで[デスティネーション支払い](https://docs.stripe.com/connect/destination-charges.md)を作成すると、ご自身のアカウントのデータ内で支払い情報を取得できます。連結アカウントへの個別の売上送金が自動的に作成され、そのアカウントで支払いが作成されます。たとえば、[デスティネーション支払いクエリテンプレート](https://dashboard.stripe.com/sigma/queries/templates/Destination%20charges)の使用により、プラットフォームで生成されたデスティネーション支払いに関するレポートを作成できます。デスティネーション支払いから連結アカウントへの売上フローを分析する方法の 1 つは、`charges` テーブルの `transfer_id` 列を `transfers` テーブルの `id` 列に結合することです。次の例では、元の支払い ID と金額、連結アカウントに送金された金額、および連結アカウントの ID と結果として生成された支払いが含まれています。

```sql
select
  date_format(date_trunc('day', charges.created), '%y-%m-%d') as day,
  charges.id,
  charges.amount as charge_amount,
  transfers.amount as transferred_amount,
  transfers.destination_id
from charges
inner join transfers
  on transfers.id=charges.transfer_id
order by day desc
limit 5
```

| 日         | ID               | charge_amount | transferred_amount | destination_id |
| --------- | ---------------- | ------------- | ------------------ | -------------- |
| 2026/3/20 | ch_acct_orWziM4… | 1,000         | 1,000              | acct_orWziM4…  |
| 2026/3/20 | ch_acct_orWziM4… | 800 件         | 800 件              | acct_orWziM4…  |
| 2026/3/20 | ch_acct_orWziM4… | 1,000         | 800 件              | acct_orWziM4…  |
| 2026/3/20 | ch_acct_orWziM4… | 1,100         | 950                | acct_orWziM4…  |
| 2026/3/20 | ch_acct_orWziM4… | 1,100         | 1,100              | acct_orWziM4…  |

連結アカウントの支払い情報と送金情報も、Connect 固有のテーブル (`connected_account_charges` など) 内で取得できます。

### チャージと送金別方式

デスティネーション支払いと同様の方法で、[支払いと送金別方式](https://docs.stripe.com/connect/separate-charges-and-transfers.md)のレポートを作成します。すべての支払いは、プラットフォームのアカウントに作成され、売上は[送金グループ](https://docs.stripe.com/connect/separate-charges-and-transfers.md)を使用して、連結アカウントに個別に送金されます。送金と送金グループを参照する連結アカウントで支払いが作成されます。

`charges` テーブルと `transfers` テーブルの両方に、`transfer_group` 列が含まれています。支払い、送金、および送金グループの情報は、Connect 固有の `connected_account_charges` テーブルで取得できます。