表示方法
エンドユーザーをurlのリンクに誘導するか、メールやメッセージに記載してください。すべての画面はDiditがホストします。
詳しくはホスト型銀行リンクを、エンドユーザーをお客様のページに戻す方法はサイトに戻るを参照してください。
お客様のサーバーは、GET /v3/bank/links/{id}/ または bank.link.completed Webhookで結果を確認します。
利用者に表示される画面
- 同意。 データを読み取る主体(お客様の名称とロゴ)、対象(口座、残高、指定した日付までさかのぼる取引)、保存期間、更新頻度、停止方法が表示されます。
- 個人または企業。 銀行が両者を区別しており、リクエストで
anyを指定した場合にのみ表示されます。 - 銀行。 選択画面には、リクエストで求められた処理に対応できる銀行が表示されます。継続的なアクセスの場合は、アクセスを維持できる銀行のみが表示されます。
- 銀行でのサインイン。 Didit の画面内ではなく、銀行が提供するページで行われます。
- 口座。 対象となるすべての口座があらかじめ選択されており、それぞれ選択を外せます。ただし、少なくとも1件は選択された状態のままになります。
- 成功。 連携された口座と、継続的なアクセスの場合はその有効期限が表示されます。
銀行への遷移
銀行自身のサインインページはフレーム内で実行できないため、Bank Linkは利用者を銀行へ移動させ、その後、利用者を元の場所に戻します。 リンクの状態はDiditのサーバー上で保持されるため、タブを閉じても、利用者がすでに与えた同意が失われることはありません。 最後に、リンクにredirect_url が設定されている場合は、利用者はそのURLへ移動します。詳しくはサイトに戻るをご覧ください。
セキュリティ
- APIキーがブラウザやアプリに渡されることはありません。
redirect_urlは、リンクを作成する時点で検証されます。サンドボックスアプリケーションでは、現時点でlocalhostアドレスのみが有効です。詳しくはサイトへの復帰を参照してください。- イベントに含まれるのはIDのみです。氏名、口座番号、トークンは含まれません。
次のステップ
- クイックスタートを実行してください。
- すべてのオプションについては、
create_linkリファレンスをご覧ください。