> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 銀行データAPI：銀行口座の接続と取引データの読み取り

> Didit の Bank Link で顧客の銀行口座を一度接続すれば、口座名義を確認し、残高と取引を継続的に取得できます。1つのAPIと1つの料金で利用可能です。

Didit の Bank data API を使うと、Bank Link を通じて個人または法人の銀行口座を接続し、口座の名義を確認できます。また、銀行と口座名義人が許可している期間中は、残高と取引明細も取得できます。
APIキーを1つ、Webhookエンドポイントを1つ、料金表を1つ使用します。これらは、本人確認、法人確認 (KYB)、AMLスクリーニングで使用するものと同じです。

> [!NOTE]
>
> **提供状況.** Bank data はサンドボックスのアプリケーションでご利用いただけます。
> 本番環境のアプリケーションからの呼び出しは、本番提供が発表されるまで `404` を返します。サンドボックスでは課金されません。
> まずは [クイックスタート](https://docs.didit.me/ja/core-technology/bank-verification/quickstart.md) から始めてください。
> 各銀行の対応状況は [対応状況のページ](https://docs.didit.me/ja/core-technology/bank-verification/coverage.md) と [金融機関一覧のエンドポイント](https://docs.didit.me/ja/standalone-apis/bank-institutions-list.md) でご確認いただけます。

## 一文で分かる全体像

**リンク**が**接続**を作成し、**接続**には**アカウント**があり、アカウントには**残高**と**取引**があります。

| オブジェクト | 概要 | 有効期間 |
| - | - | - |
| リンク | 1人のユーザーに対する[Bank Link](https://docs.didit.me/ja/core-technology/bank-verification/bank-link.md)の1回の実行です。銀行を接続するか、接続を更新します。 | 数分から数時間。その後期限切れになります。 |
| 接続 | 貴社のアプリケーションが1つの銀行を読み取ることに対する、ユーザーの許可です。同意、同期状態、ステータスを保持します。 | 単発アクセスの場合：データ取得が終了するまで。継続的アクセスの場合：同意が終了するまで。ユーザーが同意する限り、何度でも更新されます。 |
| アカウント | 接続内の1つのアカウントです。接続が存在する間は、IDが変わることはありません。 | 接続が存在する間。更新のたびにIDは同じままです。 |
| 残高 | 基準日時点におけるアカウントの、種類別の金額です。 | 同期のたびに置き換えられます。 |
| 取引 | アカウントの1件の入出金です。変更されないIDを持ちます。 | 接続が存在する間。 |

## 2つの銀行データ取得方法と、その他2つの銀行確認

| 目的 | 使用するもの | 料金の概要 |
| - | - | - |
| 残高と取引を一度だけ読み取る | `access: one_time`を指定したリンク | 確認1件あたり。詳細は[料金](https://docs.didit.me/ja/getting-started/bank-verification-pricing.md#銀行データと継続アクセス)を参照 |
| 数か月にわたって残高と取引を読み取り続ける | `access: ongoing`を指定したリンク | 有効な接続1件あたり、月額 |
| 支払いの前に、銀行口座が名義人のものかを確認する | [口座確認](https://docs.didit.me/ja/standalone-apis/bank-account-check.md)（サインイン不要） | 回答済みの確認1件あたり |
| サインインする人が口座の持ち主であることを確認する | `ownership.compare`を指定したリンク、または検証セッションの[銀行認証ステップ](https://docs.didit.me/ja/core-technology/bank-verification/verification-methods.md) | サインイン完了1件あたり |

## 違いを生む特徴

* **ひとつのプラットフォーム。** 本人確認、法人確認、AMLスクリーニング、銀行データが、ひとつのAPIキー、ひとつの契約、ひとつのコンソールを共有します。
* **一回限りでも継続的でも、ひとつのリンク。** 同じホスト型Bank Linkで、両方のアクセスに対応します。
* **口座名義人の照合は任意です。** 口座名義人を、Diditで認証済みの個人または法人と照合することも、データだけが必要な場合は照合を省くこともできます。
* **従量課金の料金を公開。** [料金ページ](https://docs.didit.me/ja/getting-started/bank-verification-pricing.md)をご覧ください。
* **安定したIDと変更フィード。** 口座と取引は、更新後も同じIDを保持します。永続カーソルを備えた変更フィードにより、変更された分だけを取得できます。
* **難しいケースを網羅したサンドボックス。** Didit Test Bank とそのテスト用顧客には、法人口座、長い取引履歴、保留中の取引、一回限りしか利用できない銀行が含まれます。

## 進むべき道を選ぶ

> [card] [クイックスタート](https://docs.didit.me/ja/core-technology/bank-verification/quickstart.md)
>
> サンドボックス用のAPIキーを使って、コピー&ペーストで使えるリクエストにより、ゼロから最初の取引まで進めます。

> [card] [会計向けの継続的なフィード](https://docs.didit.me/ja/use-cases/bank-data-for-accounting.md)
>
> 顧客ごとの残高と取引を、日次のフィードで受け取ります。

> [card] [送金前に口座を確認する](https://docs.didit.me/ja/use-cases/verify-a-payout-account.md)
>
> サインインなしで口座名義人を確認します。

> [card] [Bank Linkを表示](https://docs.didit.me/ja/core-technology/bank-verification/bank-link.md)
>
> ホスト型リンクに利用者を案内し、貴社のサイトに戻します。

## 次に読むページ

* [接続](https://docs.didit.me/ja/core-technology/bank-verification/connections.md): アクセスの継続、同意、更新、接続のステータス。
* [口座、残高、取引](https://docs.didit.me/ja/core-technology/bank-verification/accounts-balances-transactions.md): データモデルと、各銀行が送信するフィールド。
* [Webhook](https://docs.didit.me/ja/core-technology/bank-verification/webhooks.md): `bank.*` イベントと、その使い方。
* [サンドボックス](https://docs.didit.me/ja/core-technology/bank-verification/sandbox.md): Didit Test Bank とそのテスト用顧客。
* [データ、同意、削除](https://docs.didit.me/ja/core-technology/bank-verification/data-consent-and-deletion.md): 本人が同意する内容、アクセスを停止する方法、削除によって消えるもの。
* [料金](https://docs.didit.me/ja/getting-started/bank-verification-pricing.md): すべての料金を文章で記載。
* [APIリファレンス](https://docs.didit.me/ja/standalone-apis/bank-data.md): すべてのエンドポイント。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.