> ## 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: 은행 연결 및 거래 내역 조회

> Bank Link로 고객의 은행 계정을 한 번 연결하고 계좌 소유주를 확인하세요. Didit의 API 하나와 요금 하나로 잔액과 거래 내역을 계속 조회할 수 있습니다.

Didit의 Bank data API를 사용하면 Bank Link로 개인 또는 기업의 은행 계좌를 연결하고, 계좌 소유자를 확인하며, 은행과 해당 개인이 허용하는 기간 동안 잔액과 거래 내역을 조회할 수 있습니다.
하나의 API 키, 하나의 webhook endpoint, 하나의 가격표를 사용합니다. 이는 신분증 인증, 기업 확인(KYB), AML 스크리닝에 사용하는 것과 같은 것입니다.

> [!NOTE]
>
> **가용성.** 은행 데이터는 샌드박스 애플리케이션에서 사용할 수 있습니다.
> 프로덕션 환경 애플리케이션의 호출은 라이브 액세스가 공지되기 전까지 `404`로 응답하며, 샌드박스에서는 요금이 청구되지 않습니다.
> [퀵스타트](https://docs.didit.me/ko/core-technology/bank-verification/quickstart.md)부터 시작하세요.
> [커버리지 페이지](https://docs.didit.me/ko/core-technology/bank-verification/coverage.md)와 [institutions endpoint](https://docs.didit.me/ko/standalone-apis/bank-institutions-list.md)에서 각 은행이 지원하는 항목을 확인할 수 있습니다.

## 한 문장으로 보는 핵심 개념

**링크**는 **연결**을 만들고, 연결에는 **계좌**가 있으며, 계좌에는 **잔액**과 **거래**가 있습니다.

| 객체 | 설명 | 유효 기간 |
| - | - | - |
| 링크 | 한 사람을 대상으로 [Bank Link](https://docs.didit.me/ko/core-technology/bank-verification/bank-link.md)을 한 번 실행하는 과정입니다. 은행을 연결하거나 연결을 갱신합니다. | 몇 분에서 몇 시간이며, 그 뒤 만료됩니다. |
| 연결 | 여러분의 애플리케이션이 한 은행의 데이터를 읽도록 사용자가 허용한 권한입니다. 동의, 동기화 상태, 연결 상태를 포함합니다. | 일회성 접근: 데이터 수집이 끝날 때까지입니다. 지속 접근: 동의가 끝날 때까지이며, 사용자가 동의하는 만큼 자주 갱신됩니다. |
| 계좌 | 연결 안의 계좌 하나입니다. 연결이 존재하는 동안 바뀌지 않는 ID를 가집니다. | 연결이 유지되는 동안입니다. 갱신 후에도 ID는 그대로입니다. |
| 잔액 | 기준일 시점의 계좌 금액으로, 유형이 지정되어 있습니다. | 동기화할 때마다 교체됩니다. |
| 거래 | 계좌의 입출금 내역 한 건으로, 변하지 않는 ID를 가집니다. | 연결이 존재하는 동안 유지됩니다. |

## 은행 데이터를 가져오는 두 가지 방법과 두 가지 다른 은행 확인

| 원하는 작업 | 사용 항목 | 한 줄 요금 |
| - | - | - |
| 잔액과 거래 내역을 한 번만 조회 | `access: one_time` 링크 | 건당 요금은 [요금](https://docs.didit.me/ko/getting-started/bank-verification-pricing.md#은행-데이터-및-지속-접근) 페이지를 참고하세요 |
| 몇 달에 걸쳐 잔액과 거래 내역을 계속 조회 | `access: ongoing` 링크 | 활성 연결당 월별 요금 |
| 결제 전에 은행 계좌가 특정 이름의 소유인지 확인 | [계좌 확인](https://docs.didit.me/ko/standalone-apis/bank-account-check.md), 로그인 불필요 | 응답이 완료된 확인 건당 요금 |
| 로그인한 사람이 해당 계좌의 소유자인지 확인 | `ownership.compare` 링크 또는 인증 세션의 [은행 인증 단계](https://docs.didit.me/ko/core-technology/bank-verification/verification-methods.md) | 완료된 로그인당 요금 |

## 차별점

* **하나의 플랫폼.** 신분증 인증, 기업 확인, AML 스크리닝, 계좌 데이터가 하나의 API 키, 하나의 계약, 하나의 콘솔을 공유합니다.
* **일회성 또는 지속적인 액세스를 위한 하나의 링크.** 같은 호스팅 Bank Link로 두 방식을 모두 제공합니다.
* **계좌 소유자 비교는 선택 사항입니다.** 계좌 소유자를 Didit으로 인증된 개인 또는 기업과 비교하거나, 데이터만 필요한 경우 비교를 생략할 수 있습니다.
* **공개된 종량제 요금.** [요금 페이지](https://docs.didit.me/ko/getting-started/bank-verification-pricing.md)에서 확인하세요.
* **안정적인 ID와 변경 피드.** 계좌와 거래는 갱신 후에도 ID를 유지하며, 오래 유지되는 커서가 있는 변경 피드를 통해 변경된 항목만 받을 수 있습니다.
* **어려운 사례를 다루는 샌드박스.** Didit 테스트 은행과 테스트 고객에는 기업 계좌, 긴 거래 내역, 보류 중인 거래, 일회성으로만 연결되는 은행이 포함됩니다.

## 경로 선택하기

> [card] [빠른 시작](https://docs.didit.me/ko/core-technology/bank-verification/quickstart.md)
>
> 샌드박스 키를 사용해 처음부터 첫 거래까지 진행하는 데 필요한, 복사하여 붙여넣을 수 있는 요청을 제공합니다.

> [card] [회계용 지속적 피드](https://docs.didit.me/ko/use-cases/bank-data-for-accounting.md)
>
> 고객별 잔액과 거래 내역을 매일 제공하는 피드입니다.

> [card] [지급 전 계좌 확인](https://docs.didit.me/ko/use-cases/verify-a-payout-account.md)
>
> 로그인 없이 계좌 명의인을 확인합니다.

> [card] [Bank Link 표시](https://docs.didit.me/ko/core-technology/bank-verification/bank-link.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): `bank.*` 이벤트와 사용 방법.
* [샌드박스](https://docs.didit.me/ko/core-technology/bank-verification/sandbox.md): Didit Test Bank와 테스트 고객.
* [데이터, 동의 및 삭제](https://docs.didit.me/ko/core-technology/bank-verification/data-consent-and-deletion.md): 사용자가 동의하는 내용, 접근을 중단하는 방법, 삭제 시 제거되는 항목.
* [요금](https://docs.didit.me/ko/getting-started/bank-verification-pricing.md): 모든 요금을 텍스트로 제공.
* [API 레퍼런스](https://docs.didit.me/ko/standalone-apis/bank-data.md): 모든 endpoint.


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