Skip to main content
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.
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