메인 콘텐츠로 건너뛰기
은행 동의는 은행이 허용하는 기간 동안 유효하며, 그 기간이 끝나면 사용자가 직접 갱신해야 합니다. Didit은 동의가 끝나기 전에 미리 알려 주며, 같은 연결에 대해 갱신 호출을 제공합니다.

동의 기간

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

사전에 알아두기

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

갱신

요청이 성공하면 201과 함께 갱신 링크가 반환되며, 다음 응답 중 하나가 반환될 수도 있습니다. 사용자가 갱신을 완료하는 페이지는 아직 제공되지 않으므로, 오늘은 사용자를 갱신 링크로 안내하지 마십시오. 그때까지는 위의 알림을 활용해 동의가 언제 끝나는지 확인하십시오.

동의가 만료된 경우

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

관련 문서

마지막 수정일 2026년 11월 22일