银行 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。
后续步骤
- 用于会计的持续银行数据流
- 沙盒:Didit Test Bank 会触发这些事件。