Didit’s Bank Link sends the person back to your site when they finish, if your link carries a redirect_url that Didit accepts.
Without one, the person finishes on Didit’s own result page and you learn the result from the bank.link.completed webhook or from a read of the link.
Which addresses work today
In a sandbox application a plain http address on localhost, 127.0.0.1 or [::1] (any port, any path, no credentials, no fragment) works as redirect_url without registration.
Any other address is refused with 400 redirect_url_not_registered when you create the link.
Registering other return addresses is not available yet.
Create the link with a redirect URL
When the link completes, the browser goes to redirect_url by itself a few seconds after the last screen, with link_id, status and a signed state.
If the person cancels or declines, they stay on Didit’s result page, which has a button back to your address with status=failed.
Use these parameters to show a page: they are for display only.
The webhook and GET /v3/bank/links/{id}/ are the authority.
Always confirm on your server
Whatever the browser tells you, confirm with GET /v3/bank/links/{id}/ or the bank.link.completed webhook, using the link id you stored for that user.
Last modified on November 22, 2026