跳转到主要内容
Didit 的 Bank Link 会在用户完成操作后将其送回您的网站,前提是您的链接中包含 redirect_url,且 Didit 接受该地址。 如果没有这一参数,用户将在 Didit 自己的结果页面完成流程,您需要通过 bank.link.completed Webhook 或读取链接状态来获知结果。

当前可用的地址

在沙盒应用中,使用普通 http 协议、主机为 localhost、127.0.0.1 或 [::1] 的地址可直接用作 redirect_url,无需注册。端口和路径不限,但地址中不能包含凭据,也不能包含片段。 其他任何地址在创建链接时都会被拒绝,并返回 400 redirect_url_not_registered。 注册其他返回地址的功能目前尚不可用。

通过重定向 URL 创建链接

链接完成后,浏览器会在最后一个界面显示数秒后自动跳转到 redirect_url,并附带 link_id、status 和已签名的 state。 如果用户取消或拒绝操作,将停留在 Didit 的结果页面,该页面上有一个按钮,可返回您的地址,并附带 status=failed。 请仅使用这些参数来展示页面,它们仅用于展示。 最终结果以 Webhook 和 GET /v3/bank/links/{id}/ 为准。

始终在您的服务器上进行确认

无论浏览器返回什么信息,都请通过 GET /v3/bank/links/{id}/ 或 bank.link.completed Webhook 进行确认,并使用您为该用户存储的链接 ID。

相关内容

最后修改于 2026年11月22日