> ## 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은 동의가 끝나기 전에 미리 알려 주며, 같은 연결에 대해 갱신 호출을 제공합니다.

## 동의 기간

* 종료 날짜는 은행과 경로가 정하며, 요청하신 `consent_days`를 넘을 수 없습니다.
* 모든 연결은 실제 날짜를 `consent.expires_at`과 `consent.renew_by`에 표시합니다.
* 기관은 은행이 허용하는 가장 긴 동의 기간을 `consent_days_max`에 표시합니다.
* 사용자에게 고정된 일수를 약속하지 마십시오. 연결에 표시된 날짜까지라고 안내하십시오.

## 사전에 알아두기

`bank.connection.consent_expiring` 이벤트는 만료 14일, 7일, 1일 전에 전송됩니다.
만료가 임박한 연결을 목록으로 조회할 수도 있습니다:

```bash theme={null}
curl "https://verification.didit.me/v3/bank/connections/?status=active&consent_expires_before=2026-12-15" \
  -H "x-api-key: $DIDIT_API_KEY"
```

## 갱신

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/renew/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{ "redirect_url": "http://localhost:3000/bank/return" }'
```

요청이 성공하면 `201`과 함께 갱신 링크가 반환되며, 다음 응답 중 하나가 반환될 수도 있습니다.

| 응답 | 의미 |
| - | - |
| `409 renewal_not_needed` | 남은 기간이 30일을 넘습니다. 나중에 다시 시도하십시오. |
| `409 renewal_window_expired` | `consent.renewable_until`이 지났습니다. 사용자는 새 링크로 다시 연결해야 합니다. |

사용자가 갱신을 완료하는 페이지는 아직 제공되지 않으므로, 오늘은 사용자를 갱신 링크로 안내하지 마십시오.
그때까지는 위의 알림을 활용해 동의가 언제 끝나는지 확인하십시오.

## 동의가 만료된 경우

* 연결 상태가 `renewal_required`로 바뀌며, `status_reason: consent_expired` 또는 `bank_requires_sign_in`이 됩니다.
* 동기화된 데이터는 계속 조회할 수 있지만, 동기화도 청구도 이루어지지 않으며 `bank.connection.renewal_required` 이벤트가 전송됩니다.
* `consent.renewable_until` 이후에는 연결이 `revoked`로 바뀌고 `status_reason: consent_lapsed`가 설정되며, 최종 사용자가 다시 연결해야 합니다.

## 관련 문서

* [연결](https://docs.didit.me/ko/core-technology/bank-verification/connections.md)
* [회계용 지속적 은행 거래 내역 피드](https://docs.didit.me/ko/use-cases/bank-data-for-accounting.md)
* [데이터, 동의 및 삭제](https://docs.didit.me/ko/core-technology/bank-verification/data-consent-and-deletion.md)


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