> ## 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에서 연결 상태, 동의 만료 방식, 갱신 방법, 접근 중단 및 데이터 삭제 방법을 확인하세요.

Didit 은행 연결은 개인 또는 기업이 귀하의 애플리케이션에 한 은행의 정보를 읽도록 허용한 권한으로, 동의 일자, 동기화 상태, 계좌 정보를 포함합니다.
완료된 [Bank Link](https://docs.didit.me/ko/core-technology/bank-verification/bank-link.md)이 연결을 생성하며, 연결은 은행과 개인이 허용하는 기간 동안 유지됩니다.

은행 데이터는 샌드박스 애플리케이션에서 사용할 수 있습니다. 프로덕션 환경의 애플리케이션에 대한 호출은 라이브 액세스가 공지되기 전까지 `404`로 응답합니다.

## 일회성 및 지속적 액세스

| | 일회성 | 지속적 |
| - | - | - |
| `access` | `one_time` (기본값) | `ongoing` |
| 동작 방식 | 사용자가 연결할 때 데이터를 한 번 읽고, 이후 액세스는 종료됩니다(`status_reason: collection_complete`). | 동의가 끝나거나 누군가 중지할 때까지 액세스가 유지됩니다. |
| 이후 데이터 | 동일한 endpoint를 통해 읽을 수 있습니다. | 은행에 따라 하루에 한 번에서 네 번 사이로 자동 동기화되며, 필요 시 실시간 동기화도 가능합니다. |
| 요금 | 확인 건당 과금, [요금](https://docs.didit.me/ko/getting-started/bank-verification-pricing.md) 참조 | 활성 연결당 월 단위 과금, [요금](https://docs.didit.me/ko/getting-started/bank-verification-pricing.md) 참조 |

지속적 액세스는 해당 은행이 이를 허용하는 경우에만 작동합니다.
[기관 endpoint](https://docs.didit.me/ko/standalone-apis/bank-institutions-list.md)를 호출하거나 [지원 범위 페이지](https://docs.didit.me/ko/core-technology/bank-verification/coverage.md)를 확인하십시오.
은행이 액세스를 유지할 수 없는 경우, 사용자에게 해당 은행이 지속적 액세스를 허용하지 않으며 다른 은행을 선택해야 한다고 안내됩니다.
`allow_one_time_fallback: true`를 설정하면, 사용자가 자신의 화면에서 축소된 액세스를 확인한 후 일회성 읽기로 계속 진행할 수 있습니다. 이 경우 연결은 `one_time`이 됩니다.

## 상태

| `status` | 의미 | 데이터 조회 가능 여부 | 동기화 | 과금 |
| - | - | - | - | - |
| `pending` | 연결이 완료되었고 첫 동기화가 진행 중입니다. | 아직 아님 | 진행 중 | 아니요 |
| `active` | 동의가 유효하며 동기화가 정상이거나 재시도 중입니다. | 예 | 예 | 예 |
| `renewal_required` | 동의가 종료되었거나 은행이 사용자에게 다시 로그인하도록 요청합니다. 그 이유는 `status_reason`에 표시됩니다. | 마지막 동기화 시점의 데이터 | 아니요 | 아니요 |
| `paused` | 잔액으로는 해당 월의 비용을 충당할 수 없습니다. | 마지막 동기화 시점의 데이터 | 아니요 | 아니요 |
| `revoked` | 사용자, 은행 또는 귀하가 접근을 중단했습니다. 누가 중단했는지는 `consent.ended_by`에 표시됩니다. | `consent.retain_until`까지 | 아니요 | 아니요 |
| `deleted` | 연결과 해당 데이터가 삭제되었습니다. | 아니요 | 아니요 | 아니요 |
| `failed` | 첫 동기화가 한 번도 성공하지 못했습니다. | 아니요 | 아니요 | 아니요 |

`status_reason`은 `collection_complete`, `consent_expired`, `consent_lapsed`, `bank_requires_sign_in`, `revoked_by_end_user`, `revoked_by_bank`, `revoked_by_customer`, `insufficient_balance`, `paused_by_customer`(예약된 값이며 현재 이 값을 설정하는 엔드포인트는 없습니다), `first_sync_failed` 중 하나입니다.

## 동의

은행은 요청하신 `consent_days` 값을 상한으로 하여 동의 종료 시점을 정합니다.
모든 연결의 실제 날짜는 `consent`에서 확인할 수 있습니다:

* `expires_at`과 `renew_by`: 동의의 종료 시점입니다. 공백 없이 이용하려면 그 전에 갱신하십시오.
* `renewable_until`: 동의가 끝난 뒤에도 같은 연결을 되살릴 수 있는 마지막 시점입니다.
* `renewed_count`, `version`, `scopes_granted`, `accounts_granted`: 부여된 내용과 갱신된 횟수입니다.

동의 기간은 은행이 허용하는 만큼 유지됩니다.
각 연결의 실제 값과 기관별 은행 기준 값을 함께 확인하십시오.

## 갱신

갱신하면 연결 ID와 모든 계좌 ID가 그대로 유지되며, 기록은 중복 없이 이어집니다.

1. Didit는 만료 14일, 7일, 1일 전에 `bank.connection.consent_expiring` 이벤트를 전송합니다.
2. [`POST /v3/bank/connections/{id}/renew/`](https://docs.didit.me/ko/standalone-apis/bank-connection-renew)를 호출합니다. 남은 기간이 30일을 초과하면 `409 renewal_not_needed`를, `consent.renewable_until` 이후에는 `409 renewal_window_expired`를 반환합니다. 그 밖의 경우에는 갱신 링크와 함께 `201`을 반환합니다.

사용자가 갱신을 완료하는 페이지는 아직 제공되지 않으므로, 현재는 사용자를 갱신 링크로 안내하지 마십시오.

사용자가 동의를 갱신하지 않아 동의가 만료되면 연결 상태는 `renewal_required`로 바뀝니다. 이때 데이터는 마지막으로 동기화된 상태로 계속 조회할 수 있으며, 요금은 부과되지 않습니다.

`consent.renewable_until`이 지나면 연결은 `status_reason: consent_lapsed`와 함께 `revoked`(취소됨) 상태가 되며, 사용자는 다시 연결해야 합니다.

전체 절차는 [은행 동의 갱신](https://docs.didit.me/ko/use-cases/renew-bank-consent.md)을 참조하십시오.

## 접근 중단

| 대상 | 방법 | 결과 |
| - | - | - |
| 최종 사용자 | 은행에서 **공유 중지** | `bank.connection.revoked` 이벤트가 `ended_by: end_user` 또는 `bank` 값과 함께 발생합니다 |
| 귀하 | [`revoke_connection`](https://docs.didit.me/ko/standalone-apis/bank-connection-revoke) | 은행의 데이터 조회가 즉시 중단됩니다. 동의 상태는 `revocation_pending`으로 표시되었다가, 은행이 확인하면 `revoked`로 표시됩니다. 이미 읽은 데이터는 연결을 삭제하거나 `consent.retain_until`이 지날 때까지 계속 조회할 수 있습니다. |
| 귀하 | [`delete_connection`](https://docs.didit.me/ko/standalone-apis/bank-connection-delete) | 접근을 중단하고, 연결과 계좌, 잔액, 거래를 삭제합니다. 되돌릴 수 없습니다. |

접근을 중단하는 것은 삭제가 아닙니다.
삭제로 정확히 무엇이 제거되는지는 [데이터, 동의 및 삭제](https://docs.didit.me/ko/core-technology/bank-verification/data-consent-and-deletion.md)를 참조하십시오.

## 삭제된 연결

삭제된 연결의 응답에는 `id`, `status` (`deleted`), `status_reason`, `created_at`, `erasure` 필드만 포함됩니다.
`status_reason`의 값은 `deleted_by_customer`, `consent_lapsed`, `retention_elapsed` 또는 `application_deleted`입니다.
그 밖의 모든 필드는 응답에서 제외됩니다.

## 중복

`end_user.reference`가 같고 같은 은행에서 이미 공유 중인 계정과 정확히 일치하는 새 링크는 해당 연결의 갱신(`reused: true`)으로 완료되며, 요금이 두 번 청구되지 않습니다.
그 밖의 계정 중복은 아무것도 저장되거나 청구되기 전에 링크를 `failed`로 종료하고, `duplicate_conflict`와 `conflicts_with`를 반환합니다.
기존 연결을 갱신하거나, 독립된 두 번째 연결이 필요하면 `"duplicates": "allow"`를 설정하여 링크를 다시 생성하십시오.

## 고객의 연결 관리

* 필터를 사용한 목록 조회: [`GET /v3/bank/connections/`](https://docs.didit.me/ko/standalone-apis/bank-connections-list)는 `status`, `access`, `institution_id`, `country`, `vendor_data`, `end_user_reference`, `consent_expires_before`, `created_after` 필터를 받습니다.
* `billing` 객체로 연결 비용을 확인합니다: 단위, 가격, 이미 정산된 월을 볼 수 있습니다.


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