> ## 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 リダイレクトURL: 認証後に戻る先の設定

> Bank Link後にredirect_urlでユーザーをサイトへ戻します。サンドボックスではlocalhostも利用可能。未設定の場合はDiditの結果ページに遷移します。

ディディットのBank Linkでは、利用者が手続きを完了すると、リンクにDiditが受け付ける`redirect_url`が含まれている場合にあなたのサイトへ戻します。
それがない場合、利用者はDidit自身の結果ページで手続きを終えます。結果は`bank.link.completed` Webhookか、リンクの取得によって確認できます。

## サンドボックスで現在利用できるアドレス

サンドボックスアプリケーションでは、`localhost`、`127.0.0.1`、`[::1]` のいずれかを対象とする平文の `http` アドレス（ポート番号・パスは任意、認証情報およびフラグメントを含まないもの）であれば、事前登録なしで `redirect_url` として使用できます。
それ以外のアドレスは、リンクを作成する際に `400 redirect_url_not_registered` で拒否されます。
それ以外の戻り先アドレスの登録は、まだご利用いただけません。

## リダイレクトURLを指定してリンクを作成する

```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": "one_time",
    "country": "ESP",
    "redirect_url": "http://localhost:3000/bank/return",
    "vendor_data": "client-7731"
  }'
```

リンクの処理が完了すると、最後の画面が表示されてから数秒後にブラウザが自動的に`redirect_url`へ移動します。その際、`link_id`、`status`、署名付きの`state`が付与されます。
ユーザーがキャンセルまたは拒否した場合は、Diditの結果ページに留まります。このページには、`status=failed`を付けてお客様のアドレスに戻るボタンがあります。
これらのパラメーターは、ページを表示するために使用してください。表示専用です。
正式な情報源はWebhookと`GET /v3/bank/links/{id}/`です。

## 必ずサーバー側で確認する

ブラウザから受け取った情報がどのようなものであっても、そのユーザー用に保存したリンクIDを使って、`GET /v3/bank/links/{id}/` または `bank.link.completed` Webhookで確認してください。

## 関連

* [ホスト型Bank Link](https://docs.didit.me/ja/integration/bank-link/hosted-link.md)
* [クイックスタート](https://docs.didit.me/ja/core-technology/bank-verification/quickstart.md)


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