> ## 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: The Hosted Bank Connection Flow

> Bank Link is the one flow your users go through to connect a bank: create a link on your server and send the person to its hosted page.

Didit's Bank Link is the single flow in which a person connects a bank account to your product, whether you want a one-time read or ongoing access.
You create a link on your server and send the person to its hosted page.

## Show it

Send the person to the link `url`, or put it in an email or a message: Didit hosts every screen.
See [Hosted Bank Link](https://docs.didit.me/integration/bank-link/hosted-link.md), and [Return to your site](https://docs.didit.me/integration/bank-link/return-to-your-site.md) to bring the person back to your page.
Your server confirms the result with `GET /v3/bank/links/{id}/` or the `bank.link.completed` webhook.

## What the person sees

1. **Consent.** Who will read the data (your name and logo), what (accounts, balances, transactions back to a date), for how long, how often it is refreshed, and how to stop.
2. **Personal or business.** Only when the bank separates them and your request said `any`.
3. **Bank.** The picker lists the banks that can do what the link asks. With ongoing access it lists only banks that can keep access open.
4. **Sign-in at the bank.** On the bank's own page, never inside Didit's screens.
5. **Accounts.** All eligible accounts are preselected and each can be unticked, with at least one left.
6. **Success.** The accounts linked and, for ongoing access, until when.

See [Data, consent and deletion](https://docs.didit.me/core-technology/bank-verification/data-consent-and-deletion.md) for what the person agrees to and how access stops.

## The bank hop

A bank's own sign-in page cannot run inside a frame, so Bank Link sends the person to the bank and brings them back.
The state of a link lives on Didit's servers, so closing a tab never loses a consent the person already gave.
At the end the person goes to your `redirect_url` when the link has one: see [Return to your site](https://docs.didit.me/integration/bank-link/return-to-your-site.md).

## Security

* The API key never reaches a browser or an app.
* `redirect_url` is checked when you create the link: in a sandbox application only a `localhost` address works today, see [Return to your site](https://docs.didit.me/integration/bank-link/return-to-your-site.md).
* Events carry ids only: no names, no account numbers and no tokens.

## Next steps

* Run the [quickstart](https://docs.didit.me/core-technology/bank-verification/quickstart.md).
* Read the [`create_link` reference](https://docs.didit.me/standalone-apis/bank-link-create) for every option.


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