跳转到主要内容
Didit 会在链接结束、连接发生变化、同意即将到期,或同步存储新数据时发送银行 Webhook。 它们与 Didit 其他 Webhook 使用相同的消息封装格式、签名和重试机制,且仅包含 ID 和状态。您需要获取对应对象才能读取其内容。
银行 Webhook 事件会为生产环境应用和沙盒应用发送。 请使用 Webhook 目标的事件过滤器为每个目标选择事件,与其他事件的做法相同。 消息封装格式、签名请求头和重试机制的说明,请参阅 Webhooks。

事件

每个事件还包含以下公共字段:event_id、webhook_type、timestamp、created_at、application_id 和 environment。 bank.link.* 事件的字段位于 data 下;连接、数据和同步事件的字段位于顶层。 ended_by 的取值为 end_user、bank、customer 或 unknown。 每个事件的确切结构请参阅 API 参考。

示例

如何使用

  • 新数据。 bank.data.updated 仅是信号,不会推送任何数据。请使用已存储的游标调用变更流。只有当您希望查看每次同步(包括未产生任何变更的同步)时,才使用 bank.sync.completed。
  • 入驻。 在读取账户之前,请等待 bank.connection.created;在依赖完整历史记录之前,请等待 bank.connection.history_complete。
  • 同意。 收到 bank.connection.consent_expiring 时,请用户续期。收到 bank.connection.renewal_required 时,数据仍可读取,但不再同步。
  • 停止。 收到 bank.connection.revoked 时,请停止该连接对应的自有数据流,并决定是否删除已存储的数据。
  • 重复事件。 以幂等方式处理每个事件:以事件 ID 作为键,并且偶尔会收到同一事件两次。
  • 切勿信任浏览器。 请通过 bank.link.completed 或 GET /v3/bank/links/{id}/ 确认链接,而不要使用页面发送的链接 ID。

后续步骤

最后修改于 2026年11月22日