> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 은행 데이터 API: 은행 링크, 연결, 계좌 및 거래 내역

> Didit의 모든 은행 데이터 엔드포인트입니다. 은행 링크 생성, 연결 관리, 계좌·잔액·거래 내역 조회, 변경 피드 확인, 은행 목록 검색을 지원합니다.

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 키가 필요합니다. 전체 액세스 권한에는 이 권한이 포함되지 않습니다.
[계좌 확인](https://docs.didit.me/ko/standalone-apis/bank-account-check.md)은 이 권한을 사용하지 않으며, 세션에 대한 쓰기 권한이 있는 API 키 또는 전체 액세스 권한이 있는 API 키가 필요합니다.
Bank data는 샌드박스 애플리케이션에서 사용할 수 있습니다. 라이브 애플리케이션의 호출은 라이브 액세스가 공지되기 전까지 `404`로 응답하며, 샌드박스에서는 요금이 부과되지 않습니다.

## 링크

> [card] [링크 생성](https://docs.didit.me/ko/standalone-apis/bank-link-create.md)
>
> `POST /v3/bank/links/`

> [card] [링크 조회](https://docs.didit.me/ko/standalone-apis/bank-link-get.md)
>
> `GET /v3/bank/links/{id}/`

> [card] [링크 취소](https://docs.didit.me/ko/standalone-apis/bank-link-cancel.md)
>
> `POST /v3/bank/links/{id}/cancel/`

## 연결

> [card] [연결 목록 조회](https://docs.didit.me/ko/standalone-apis/bank-connections-list.md)
>
> `GET /v3/bank/connections/`

> [card] [연결 조회](https://docs.didit.me/ko/standalone-apis/bank-connection-get.md)
>
> `GET /v3/bank/connections/{id}/`

> [card] [새로 고침](https://docs.didit.me/ko/standalone-apis/bank-connection-refresh.md)
>
> `POST /v3/bank/connections/{id}/refresh/`

> [card] [갱신](https://docs.didit.me/ko/standalone-apis/bank-connection-renew.md)
>
> `POST /v3/bank/connections/{id}/renew/`

> [card] [해지](https://docs.didit.me/ko/standalone-apis/bank-connection-revoke.md)
>
> `POST /v3/bank/connections/{id}/revoke/`

> [card] [삭제](https://docs.didit.me/ko/standalone-apis/bank-connection-delete.md)
>
> `DELETE /v3/bank/connections/{id}/`

> [card] [동기화 실행 목록](https://docs.didit.me/ko/standalone-apis/bank-sync-runs-list.md)
>
> `GET /v3/bank/connections/{id}/sync-runs/`

> [card] [동기화 실행 조회](https://docs.didit.me/ko/standalone-apis/bank-sync-run-get.md)
>
> `GET /v3/bank/connections/{id}/sync-runs/{sync_id}/`

## 계좌, 잔액 및 거래

> [card] [계좌 목록 조회](https://docs.didit.me/ko/standalone-apis/bank-accounts-list.md)
>
> `GET /v3/bank/connections/{id}/accounts/`

> [card] [계좌 조회](https://docs.didit.me/ko/standalone-apis/bank-account-get.md)
>
> `GET /v3/bank/accounts/{account_id}/`

> [card] [잔액 조회](https://docs.didit.me/ko/standalone-apis/bank-account-balances.md)
>
> `GET /v3/bank/accounts/{account_id}/balances/`

> [card] [거래 내역 목록 조회](https://docs.didit.me/ko/standalone-apis/bank-account-transactions.md)
>
> `GET /v3/bank/accounts/{account_id}/transactions/`

> [card] [거래 변경 피드](https://docs.didit.me/ko/standalone-apis/bank-transactions-sync.md)
>
> `GET /v3/bank/connections/{id}/transactions/sync/`

## 은행 및 지원 범위

> [card] [기관 목록 조회](https://docs.didit.me/ko/standalone-apis/bank-institutions-list.md)
>
> `GET /v3/bank/institutions/`

> [card] [기관 조회](https://docs.didit.me/ko/standalone-apis/bank-institution-get.md)
>
> `GET /v3/bank/institutions/{id}/`

> [card] [지원 범위 조회](https://docs.didit.me/ko/standalone-apis/bank-coverage.md)
>
> `GET /v3/bank/coverage/`

> [card] [계좌 확인](https://docs.didit.me/ko/standalone-apis/bank-account-check.md)
>
> `POST /v3/bank/account-check/`

## 가이드

* [뱅크 데이터 빠른 시작](https://docs.didit.me/ko/core-technology/bank-verification/quickstart.md)
* [연결](https://docs.didit.me/ko/core-technology/bank-verification/connections.md)
* [계정, 잔액 및 거래](https://docs.didit.me/ko/core-technology/bank-verification/accounts-balances-transactions.md)
* [뱅크 webhook](https://docs.didit.me/ko/core-technology/bank-verification/webhooks.md)
* [샌드박스](https://docs.didit.me/ko/core-technology/bank-verification/sandbox.md)
* [요금](https://docs.didit.me/ko/getting-started/bank-verification-pricing.md)

## 서버 SDK

서버 SDK 7종은 `bank` 리소스 아래에서 다음 작업들을 제공하며, 메서드 이름은 작업 이름을 따릅니다: `create_link`, `get_connection`, `sync_transactions` 등.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.