은행 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를 기준으로 식별하고, 같은 이벤트가 간혹 두 번 도착할 수 있다고 가정하세요.
- 브라우저를 신뢰하지 마세요. 페이지가 전송한 링크 ID가 아니라
bank.link.completed또는GET /v3/bank/links/{id}/로 링크를 확인하세요.
Next steps
- 회계를 위한 지속적인 은행 거래 내역 피드
- 샌드박스: Didit Test Bank에서 이 이벤트들이 발생합니다.