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

# 銀行口座連携リンク: ホスト型で送るだけ、コード不要

> サーバーでリンクを作成し、URLをユーザーに送るだけで済みます。Didit がすべての画面をホストし、完了後は `redirect_url` に戻せます。

Diditのホスト型Bank Linkは、現在銀行を接続する方法です。リンクを作成し、利用者をそのリンクの`url`に誘導すると、Diditがすべての画面を自社のページで表示します。
銀行データはサンドボックスのアプリケーションでご利用いただけます。本番環境での提供が発表されるまで、本番アプリケーションからの呼び出しは`404`を返します。

## リンクを作成して利用者に送信する

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{
    "access": "ongoing",
    "country": "ESP",
    "data": ["accounts", "balances", "transactions"],
    "end_user": { "reference": "client-7731" },
    "vendor_data": "client-7731"
  }'
```

レスポンスに含まれる`url`にブラウザーをリダイレクトするか、それをメールやメッセージに記載してください。
`url`はリンクの作成時にのみ返されます。リンクは有効期限が切れると使用できなくなります（デフォルトは60分で、`expires_in`を指定すると5分から24時間の間で設定できます）。

## 最後に起こること

* `redirect_url` がDiditに受け付けられた場合、ブラウザーはそのURLに戻ります。詳しくは [サイトへの戻り方](https://docs.didit.me/ja/integration/bank-link/return-to-your-site.md) を参照してください。
* リダイレクトURLがない場合、フローはDiditの結果ページで終了します。
* いずれの場合も、`bank.link.completed` Webhookと`GET /v3/bank/links/{id}/`で結果を確認できます。

## サーバーで確認する

`bank.link.completed` を受信したら、そのユーザーについて保存しておいたリンクIDを使って `GET /v3/bank/links/{id}/` を呼び出してください。
成功した場合は `status: completed` と `connection_id` を返し、最終的に失敗した場合は `error.code` を返します。
その後、[クイックスタート](https://docs.didit.me/ja/core-technology/bank-verification/quickstart.md#ステップ4-webhookを受信して確認する)に進んでください。


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