메인 콘텐츠로 건너뛰기
Didit의 Bank data API는 Bank Link로 사용자의 은행을 연결하고, 사용자가 허용하는 기간 동안 연결을 유지하며, 계좌, 잔액, 거래 내역을 제공합니다. 기본 URL은 https://verification.didit.me/v3/이며, 모든 독립형 API와 마찬가지로 애플리케이션 API 키를 x-api-key 헤더에 담아 인증합니다. 모든 쓰기 요청은 Idempotency-Key를 받습니다. 목록 조회는 limit(기본값 100, 최대 500)을 받고 cursor로 다음 페이지를 이어서 가져옵니다. 다만 거래 조회는 예외입니다. 날짜 범위 조회는 page_token으로 이어서 가져오고, 변경 피드는 영속적인 cursor를 받으며 page_token으로 페이지를 이어서 가져옵니다. 조회 요청에는 요금이 부과되지 않습니다. 오류에는 code, message, request_id, field, next_action, retry_after가 포함되며, code를 기준으로 분기하세요. 계좌 확인을 제외한 모든 작업에는 Bank data 권한이 있는 API 키가 필요합니다. 전체 액세스 권한에는 이 권한이 포함되지 않습니다. 계좌 확인은 이 권한을 사용하지 않으며, 세션에 대한 쓰기 권한이 있는 API 키 또는 전체 액세스 권한이 있는 API 키가 필요합니다. Bank data는 샌드박스 애플리케이션에서 사용할 수 있습니다. 라이브 애플리케이션의 호출은 라이브 액세스가 공지되기 전까지 404로 응답하며, 샌드박스에서는 요금이 부과되지 않습니다.

링크

링크 생성

POST /v3/bank/links/

링크 조회

GET /v3/bank/links/{id}/

링크 취소

POST /v3/bank/links/{id}/cancel/

연결

연결 목록 조회

GET /v3/bank/connections/

연결 조회

GET /v3/bank/connections/{id}/

새로 고침

POST /v3/bank/connections/{id}/refresh/

갱신

POST /v3/bank/connections/{id}/renew/

해지

POST /v3/bank/connections/{id}/revoke/

삭제

DELETE /v3/bank/connections/{id}/

동기화 실행 목록

GET /v3/bank/connections/{id}/sync-runs/

동기화 실행 조회

GET /v3/bank/connections/{id}/sync-runs/{sync_id}/

계좌, 잔액 및 거래

계좌 목록 조회

GET /v3/bank/connections/{id}/accounts/

계좌 조회

GET /v3/bank/accounts/{account_id}/

잔액 조회

GET /v3/bank/accounts/{account_id}/balances/

거래 내역 목록 조회

GET /v3/bank/accounts/{account_id}/transactions/

거래 변경 피드

GET /v3/bank/connections/{id}/transactions/sync/

은행 및 지원 범위

기관 목록 조회

GET /v3/bank/institutions/

기관 조회

GET /v3/bank/institutions/{id}/

지원 범위 조회

GET /v3/bank/coverage/

계좌 확인

POST /v3/bank/account-check/

가이드

서버 SDK

서버 SDK 7종은 bank 리소스 아래에서 다음 작업들을 제공하며, 메서드 이름은 작업 이름을 따릅니다: create_link, get_connection, sync_transactions 등.
마지막 수정일 2026년 11월 22일