메인 콘텐츠로 건너뛰기
Didit 은행 연결은 개인 또는 기업이 귀하의 애플리케이션에 한 은행의 정보를 읽도록 허용한 권한으로, 동의 일자, 동기화 상태, 계좌 정보를 포함합니다. 완료된 Bank Link이 연결을 생성하며, 연결은 은행과 개인이 허용하는 기간 동안 유지됩니다. 은행 데이터는 샌드박스 애플리케이션에서 사용할 수 있습니다. 프로덕션 환경의 애플리케이션에 대한 호출은 라이브 액세스가 공지되기 전까지 404로 응답합니다.

일회성 및 지속적 액세스

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

상태

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/를 호출합니다. 남은 기간이 30일을 초과하면 409 renewal_not_needed를, consent.renewable_until 이후에는 409 renewal_window_expired를 반환합니다. 그 밖의 경우에는 갱신 링크와 함께 201을 반환합니다.
사용자가 갱신을 완료하는 페이지는 아직 제공되지 않으므로, 현재는 사용자를 갱신 링크로 안내하지 마십시오. 사용자가 동의를 갱신하지 않아 동의가 만료되면 연결 상태는 renewal_required로 바뀝니다. 이때 데이터는 마지막으로 동기화된 상태로 계속 조회할 수 있으며, 요금은 부과되지 않습니다. consent.renewable_until이 지나면 연결은 status_reason: consent_lapsed와 함께 revoked(취소됨) 상태가 되며, 사용자는 다시 연결해야 합니다. 전체 절차는 은행 동의 갱신을 참조하십시오.

접근 중단

접근을 중단하는 것은 삭제가 아닙니다. 삭제로 정확히 무엇이 제거되는지는 데이터, 동의 및 삭제를 참조하십시오.

삭제된 연결

삭제된 연결의 응답에는 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/는 status, access, institution_id, country, vendor_data, end_user_reference, consent_expires_before, created_after 필터를 받습니다.
  • billing 객체로 연결 비용을 확인합니다: 단위, 가격, 이미 정산된 월을 볼 수 있습니다.
마지막 수정일 2026년 11월 22일