> ## 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.

# 銀行口座連携（Bank Link）：ホスト型の銀行接続フロー

> Bank Linkは、ユーザーが銀行を接続するための唯一のフローです。サーバーでリンクを作成し、ユーザーをそのホスト型ページに誘導します。Diditが提供します。

ディディットのBank Linkは、利用者が銀行口座をお客様のプロダクトに接続するための単一のフローです。一回限りの取得でも、継続的なアクセスでも使えます。
お客様のサーバーでリンクを作成し、利用者をそのホスト型ページへ案内します。

## 表示方法

エンドユーザーを`url`のリンクに誘導するか、メールやメッセージに記載してください。すべての画面はDiditがホストします。
詳しくは[ホスト型銀行リンク](https://docs.didit.me/ja/integration/bank-link/hosted-link.md)を、エンドユーザーをお客様のページに戻す方法は[サイトに戻る](https://docs.didit.me/ja/integration/bank-link/return-to-your-site.md)を参照してください。
お客様のサーバーは、`GET /v3/bank/links/{id}/` または `bank.link.completed` Webhookで結果を確認します。

## 利用者に表示される画面

1. **同意。** データを読み取る主体（お客様の名称とロゴ）、対象（口座、残高、指定した日付までさかのぼる取引）、保存期間、更新頻度、停止方法が表示されます。
2. **個人または企業。** 銀行が両者を区別しており、リクエストで `any` を指定した場合にのみ表示されます。
3. **銀行。** 選択画面には、リクエストで求められた処理に対応できる銀行が表示されます。継続的なアクセスの場合は、アクセスを維持できる銀行のみが表示されます。
4. **銀行でのサインイン。** Didit の画面内ではなく、銀行が提供するページで行われます。
5. **口座。** 対象となるすべての口座があらかじめ選択されており、それぞれ選択を外せます。ただし、少なくとも1件は選択された状態のままになります。
6. **成功。** 連携された口座と、継続的なアクセスの場合はその有効期限が表示されます。

利用者が何に同意するか、アクセスがどのように停止されるかについては、[データ、同意、削除](https://docs.didit.me/ja/core-technology/bank-verification/data-consent-and-deletion.md)をご覧ください。

## 銀行への遷移

銀行自身のサインインページはフレーム内で実行できないため、Bank Linkは利用者を銀行へ移動させ、その後、利用者を元の場所に戻します。
リンクの状態はDiditのサーバー上で保持されるため、タブを閉じても、利用者がすでに与えた同意が失われることはありません。
最後に、リンクに `redirect_url` が設定されている場合は、利用者はそのURLへ移動します。詳しくは[サイトに戻る](https://docs.didit.me/ja/integration/bank-link/return-to-your-site.md)をご覧ください。

## セキュリティ

* APIキーがブラウザやアプリに渡されることはありません。
* `redirect_url` は、リンクを作成する時点で検証されます。サンドボックスアプリケーションでは、現時点で `localhost` アドレスのみが有効です。詳しくは[サイトへの復帰](https://docs.didit.me/ja/integration/bank-link/return-to-your-site.md)を参照してください。
* イベントに含まれるのはIDのみです。氏名、口座番号、トークンは含まれません。

## 次のステップ

* [クイックスタート](https://docs.didit.me/ja/core-technology/bank-verification/quickstart.md)を実行してください。
* すべてのオプションについては、[`create_link` リファレンス](https://docs.didit.me/ja/standalone-apis/bank-link-create)をご覧ください。


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