> ## 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.

# 은행 데이터 지원 범위: 국가, 은행 및 기능

> Didit 은행 데이터가 지원하는 국가와 은행을 확인하세요. 로그인 33개국, 계좌 확인 47개국, 은행별 지속 접근, 동의 기간, 이력 값을 제공합니다.

Didit의 은행 지원 범위는 두 개의 계층으로 구성됩니다. 하나는 각 방식을 사용할 수 있는 국가이고, 다른 하나는 은행별 기능입니다. 두 정보 모두 API에서 제공되므로, 이 페이지에서는 구조만 설명하며 현재 기준으로 정확한 정보는 엔드포인트가 반환하는 응답입니다.

## 국가

* **은행 로그인:** 33개국.
* **계좌 확인:** 47개국. [계좌 확인 API](https://docs.didit.me/ko/standalone-apis/bank-account-check.md)를 직접 호출하든 인증 플로우 안에서 사용하든 지원 국가와 가격은 같습니다. 법인 계정 소유자는 중국을 제외한 모든 국가에서 서비스를 받을 수 있습니다.
* **두 방식 모두:** 23개국. 한 가지 이상의 방식: 57개국.
* **지속적 접근:** 은행에 따라 다릅니다. coverage 및 institutions endpoint를 통해 이를 제공하는 은행을 확인할 수 있습니다.
* **샌드박스:** Didit Test Bank입니다. [샌드박스](https://docs.didit.me/ko/core-technology/bank-verification/sandbox.md)를 참고하세요.

국가별 가격은 [요금 페이지](https://docs.didit.me/ko/getting-started/bank-verification-pricing.md)에서 확인할 수 있습니다.

## API에서 커버리지 조회하기

[`GET /v3/bank/coverage/`](https://docs.didit.me/ko/standalone-apis/bank-coverage) 요청은 국가당 한 개의 행을 반환합니다:

| 필드 | 의미 |
| - | - |
| `sign_in_available`, `account_check_available` | 해당 국가에서 제공하는 방식입니다. |
| `ongoing_access` | 해당 국가에서 최소 한 곳의 은행이 지속적인 액세스를 제공합니다. |
| `institutions`, `ongoing_institutions` | 목록에 있는 은행 수와 그중 지속적인 액세스를 제공하는 은행 수입니다. |
| `consent_days_max` | 해당 국가의 은행이 허용하는 가장 긴 동의 기간입니다. |
| `history_days_max` | 해당 국가의 은행이 제공하는 가장 긴 거래 내역 기간입니다. |
| `business_accounts` | 최소 한 곳의 은행이 기업 계좌를 지원합니다. |

## 은행 지원 여부 조회

[`GET /v3/bank/institutions/`](https://docs.didit.me/ko/standalone-apis/bank-institutions-list)는 `country`, `segment`, `access`, `q`로 필터링할 수 있으며, [`GET /v3/bank/institutions/{id}/`](https://docs.didit.me/ko/standalone-apis/bank-institution-get)는 은행 한 곳의 정보를 반환합니다.

| 항목 | 설명 |
| - | - |
| `segments` | `personal`, `business` 또는 둘 다입니다. |
| `access` 및 `ongoing_access` | 은행이 `one_time` 및 `ongoing` 접근을 허용하는지 여부입니다. |
| `consent_days_max` | 은행이 허용하는 최대 동의 기간입니다. |
| `history_days_max` | 은행이 제공하는 최대 거래 내역 기간입니다. |
| `pending_transactions`, `pending_linkage` | 은행이 대기 중인 거래를 제공하는지, 그리고 이를 확정된 거래와 연결하는지 여부입니다. |
| `balance_types`, `transaction_fields` | 은행이 전송하는 것으로 알려진 잔액 유형과 거래 필드입니다. |
| `corporate_accounts` | 기업 계좌를 지원하는지 여부입니다. |
| `sign_in` | 사용자가 로그인하는 방식으로, `redirect`, `app_approval` 또는 `credentials`입니다. |
| `reconfirmation` | 은행 로그인 없이 Didit 화면에서 갱신을 재확인할 수 있는지 여부입니다. |
| `sync_frequency_hours` | 은행이 더 빠른 주기를 허용하는 경우 자동 동기화 사이의 시간(시간 단위)입니다. `null`은 은행의 기본값을 의미하며, 하루에 한 번에서 네 번 사이입니다. |
| `timezone` | 은행 날짜에 사용되는 IANA 시간대입니다. |
| `health` | `operational`, `degraded` 또는 `down`입니다. |

Didit이 한 번도 확인하지 않은 값은 추측이 아니라 `null`로 표시되며, 값은 매일 갱신됩니다.

> [!NOTE]
>
> 지속적 접근은 은행별, 세그먼트별로 제공됩니다.
> `ongoing_access` 필드는 모든 집계의 단일 기준이므로, 지원 국가에 있는 은행이라고 해서 지속적 접근을 지원한다고 가정하지 말고 이 필드를 확인하십시오.

## 은행이 지원되지 않는 경우

* `access: ongoing`이고 미리 선택한 은행이 접근 권한을 계속 유지할 수 없는 경우, 링크는 `400 ongoing_access_not_available`을 반환합니다.
* `allow_one_time_fallback: true`를 설정하면 사용자가 일회성 조회로 계속 진행할 수 있습니다.
* 소유권 확인만 필요한 경우 로그인이 필요 없는 [계좌 확인](https://docs.didit.me/ko/core-technology/bank-verification/account-check.md)을 사용하세요.
* 다른 [대체 방법](https://docs.didit.me/ko/core-technology/bank-verification/fallbacks.md)을 확인하세요.


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