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

表示方法

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

利用者に表示される画面

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

銀行への遷移

銀行自身のサインインページはフレーム内で実行できないため、Bank Linkは利用者を銀行へ移動させ、その後、利用者を元の場所に戻します。 リンクの状態はDiditのサーバー上で保持されるため、タブを閉じても、利用者がすでに与えた同意が失われることはありません。 最後に、リンクに redirect_url が設定されている場合は、利用者はそのURLへ移動します。詳しくはサイトに戻るをご覧ください。

セキュリティ

  • APIキーがブラウザやアプリに渡されることはありません。
  • redirect_url は、リンクを作成する時点で検証されます。サンドボックスアプリケーションでは、現時点で localhost アドレスのみが有効です。詳しくはサイトへの復帰を参照してください。
  • イベントに含まれるのはIDのみです。氏名、口座番号、トークンは含まれません。

次のステップ

最終更新日 2026年11月22日