# 入金照合レポート

連結アカウントが入金照合レポートを表示およびエクスポートできるようにします。

入金照合レポートコンポーネントを使用すると、連結アカウントは、各[自動入金](https://docs.stripe.com/connect/manage-payout-schedule.md)を売上処理する取引のバッチと照合するレポートを表示およびエクスポートできます。レポートには、次の 3 つのサブレポートが表示されます。

- **残高のサマリー**: 選択した日付範囲の期首と期末の Stripe 残高が、その期間内のアクティビティの概要とともに表示されます。
- **入金の消し込み**: 選択した日付範囲内に連結アカウントの銀行アカウントで受け取った自動入金の内訳。取引はレポートカテゴリーごとにグループ化されています。
- **期末残高消し込み**: レポートの終了日時点で売上処理されていない取引の内訳。

連結アカウントは、レポートを日付範囲と通貨でフィルタリングできます。また、各サブレポートをサマリーまたは項目別の CSV ダウンロードとしてエクスポートできます。

これらのサブレポートは、[直接の Stripe アカウントの入金照合レポート](https://docs.stripe.com/reports/payout-reconciliation.md)に似ています。

## コンポーネントの提供状況

連結アカウントが自動入金を使用しない場合、入金照合レポートコンポーネントは何も表示されません。`onReportAvailabilityLoaded` コールバックを使用してこの状態を検出し、独自の空の状態または代替 UI を表示します。

連結アカウントが自動入金から手動入金に変わった場合、このコンポーネントは入金データを表示しません。連結アカウントが手動入金から自動入金に変わった場合、このコンポーネントには自動入金のデータのみが含まれます。

[残高レポートコンポーネント](https://docs.stripe.com/connect/supported-embedded-components/balance-report.md)は、入金タイプに関係なく、すべての連結アカウントの入金データをレンダリングします。

> [全 Stripe ダッシュボード](https://docs.stripe.com/connect/stripe-dashboard.md) にアクセスできない連結アカウントは、プラットフォームで特別にバックフィルされていない限り、2026 年 4 月 1 日以降のデータのみを表示できます。

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

[アカウントセッションを作成](https://docs.stripe.com/api/account_sessions/create.md)するときに、`components` パラメーターで `payout_reconciliation_report` を指定して、入金照合レポートを有効にします。

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[payout_reconciliation_report][enabled]=true"
```

アカウントセッションを作成して [ConnectJS を初期化](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions)すると、フロントエンドに入金照合レポートコンポーネントを表示できます。

#### JavaScript

```javascript
// Include this element in your HTML
const payoutReconciliationReport = stripeConnectInstance.create(
  "payout-reconciliation-report"
);
container.appendChild(payoutReconciliationReport);

// Optional: Set a callback to handle report availability.
// The payout reconciliation report is only available for accounts
// on automatic payouts. Use this callback to show your own empty
// state when the report is unavailable.
payoutReconciliationReport.setOnReportAvailabilityLoaded(
  ({ isReportAvailable }) => {
    if (!isReportAvailable) {
      // Hide the component container or show a custom message
      container.style.display = "none";
      document.getElementById("fallback-message").textContent =
        "Payout reconciliation reports are only available for accounts that " +
        "use automatic payouts.";
    }
  }
);
```

#### HTML + JS

| 決済方法                            | 種類                                       | 説明                                                                                                                                                                |
| ------------------------------- | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `setOnReportAvailabilityLoaded` | `({isReportAvailable: boolean}) => void` | コンポーネントがこの連結アカウントで入金照合レポートを利用できるかどうかを判断したときに呼び出されるコールバック。アカウントが自動入金を使用している場合は true を、手動入金を使用している場合は false を返します。このメソッドを使用して、コンポーネントを条件付きでレンダリングするか、独自の空の状態を表示します。 |

#### React

| React プロパティ                  | 種類                                       | 説明                                                                                                                                                                |
| ---------------------------- | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `onReportAvailabilityLoaded` | `({isReportAvailable: boolean}) => void` | コンポーネントがこの連結アカウントで入金照合レポートを利用できるかどうかを判断したときに呼び出されるコールバック。アカウントが自動入金を使用している場合は true を、手動入金を使用している場合は false を返します。このメソッドを使用して、コンポーネントを条件付きでレンダリングするか、独自の空の状態を表示します。 |

## 複数のプラットフォームに連結されたアカウント

プラットフォームのみで管理されていない連結アカウントの場合:

- このレポートには、アカウントが連結されているすべてのプラットフォームからの取引が含まれます。
- 連結アカウントは、レポートを表示する前に[ユーザー認証](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#user-authentication-in-connect-embedded-components)を完了する必要があります。