메인 콘텐츠로 건너뛰기
POST
curl
Didit의 은행 연결 취소 endpoint는 은행 접근을 차단하며, 취소를 요청하는 순간 은행 데이터 조회도 중단됩니다. 취소한다고 해서 아무것도 삭제되지는 않습니다. 삭제하려면 삭제를 사용하십시오. 동의 상태는 은행이 확인하기 전까지 revocation_pending으로 표시되며, 은행이 확인하면 revoked로 바뀝니다.

인증

x-api-key
string
header
필수

귀사 애플리케이션의 API 키입니다. Business Console의 Developers -> API keys에서 확인할 수 있습니다. 기본 키는 모든 권한을 가집니다. 명명된 키는 범위를 지정할 수 있습니다. 리소스별로 권한 없음, 읽기 또는 쓰기를 설정할 수 있고, 일부 워크플로나 승인된 세션으로 제한할 수 있으며, 허용된 IP 목록으로 제한할 수 있고, 만료일을 설정할 수 있습니다. 401은 키가 잘못되었거나, 취소되었거나, 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스 또는 작업에 대한 권한이 없거나, 요청이 IP 목록 밖의 주소에서 왔음을 의미합니다. 세션 경로에서 발생한 404는 세션이 키의 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 동영상 및 PDF URL을 null로 받으며, 세션 쓰기 권한이 없는 키는 세션 링크와 토큰을 null로 받습니다. 자세한 내용은 https://docs.didit.me/console/api-keys 를 참조합니다.

헤더

Idempotency-Key
string

한 작업을 위해 직접 정하는 선택적 재시도 안전 키입니다. 최대 255자이며 UUID를 사용할 수 있습니다. 같은 키, 엔드포인트, 쿼리, 본문으로 반복된 요청에는 첫 번째 응답이 같은 상태 코드와 같은 본문으로 반환되며, 다시 실행되거나 다시 과금되지 않습니다. 같은 키를 다른 엔드포인트, 쿼리 또는 본문과 함께 사용하면 409 idempotency_key_reused가 반환되고, 첫 번째 요청이 아직 실행 중이면 Retry-After와 함께 409 idempotency_key_in_progress가 반환됩니다. 실패한 요청(모든 4xx 또는 5xx)은 저장되지 않으므로 같은 키로 다시 보낼 수 있습니다. 키는 API 키로 호출하든 액세스 토큰으로 호출하든 사용자의 애플리케이션에 속합니다. 재시도 및 멱등성을 참고하세요.

Required string length: 1 - 255

경로 매개변수

id
string<uuid>
필수

연결 ID입니다.

응답

철회 상태가 있는 연결입니다.

애플리케이션이 한 은행의 데이터를 읽을 수 있도록 사용자가 부여한 권한입니다. 갱신하면 연결 ID와 모든 계정 ID가 유지됩니다. 삭제된 연결은 id, status, status_reason, created_at, erasure만 응답하며, 다른 모든 필드는 없고 은행, 사용자 또는 계정 데이터는 남지 않습니다.

id
string<uuid>
필수

연결의 ID입니다.

status
enum<string>
필수

pending: 첫 동기화가 진행 중입니다. active: 동의가 유효합니다. renewal_required: 동의가 종료되었거나 은행이 최종 사용자에게 다시 로그인하도록 요구합니다. 데이터는 마지막 동기화 상태로 읽을 수 있으며 요금은 부과되지 않습니다. paused: 해당 월의 잔액이 부족합니다. revoked: 최종 사용자, 은행 또는 귀사에 의해 접근이 중단되었습니다. deleted: id, status, status_reason, created_at, erasure만 남습니다. failed: 첫 동기화가 한 번도 성공하지 못했습니다.

사용 가능한 옵션:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
status_reason
enum<string> | null
필수

연결이 이 상태에 있는 이유입니다. paused_by_customer는 예약되어 있습니다. deleted 연결의 경우 deleted_by_customer, consent_lapsed, retention_elapsed 또는 application_deleted입니다.

사용 가능한 옵션:
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,
deleted_by_customer,
retention_elapsed,
application_deleted,
null
erasure
object | null
필수

delete_connection 이후에 설정되며, 그 외에는 null입니다.

created_at
string<date-time>
필수
environment
enum<string>
사용 가능한 옵션:
live,
sandbox
access
enum<string>
사용 가능한 옵션:
one_time,
ongoing
institution
object

연결 또는 링크의 대상 은행입니다.

segment
enum<string> | null
사용 가능한 옵션:
personal,
business,
null
data
enum<string>[]

사용자가 수락한 스코프입니다.

사용 가능한 옵션:
accounts,
balances,
transactions

이 연결에 대한 사용자의 동의입니다.

sync
object

연결의 동기화 상태입니다.

accounts
object[]

연결에 포함된 모든 계좌의 요약입니다. 계좌의 전체 정보는 get_account로 조회합니다.

ownership
object

계좌 명의인을 개인 또는 기업과 비교하는 선택 사항입니다.

end_user
object
manage_url
string<uri> | null

사용자 본인의 액세스 페이지입니다. 액세스 페이지를 사용할 수 있을 때까지 null입니다.

billing
object

이 연동의 비용입니다. 샌드박스는 어떤 경우에도 요금이 부과되지 않습니다.

possible_duplicate_of
string<uuid> | null

이 연결이 다른 활성 연결과 중복될 수 있지만 end_user.reference로 확실한 일치를 판단할 수 없는 경우 설정됩니다.

vendor_data
string | null
updated_at
string<date-time>
마지막 수정일 2026년 11월 22일