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가 그대로 유지되며, 기록은 중복 없이 이어집니다.- Didit는 만료 14일, 7일, 1일 전에
bank.connection.consent_expiring이벤트를 전송합니다. 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객체로 연결 비용을 확인합니다: 단위, 가격, 이미 정산된 월을 볼 수 있습니다.