메인 콘텐츠로 건너뛰기
POST
curl
Didit의 은행 링크 취소(Cancel a Bank Link) 엔드포인트는 사용자가 완료하지 않은 링크를 종료하므로, 해당 링크의 url과 토큰은 더 이상 작동하지 않습니다. 사용자가 과정을 중단하거나 같은 사용자에 대해 새 링크를 만들 때 이 엔드포인트를 사용하십시오. 이미 완료된 링크를 취소해도 아무것도 바뀌지 않으며, 200과 함께 링크가 그대로 반환됩니다. 접근을 막으려면 철회를 사용하십시오.

인증

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입니다.

응답

cancelled 상태가 된 링크입니다. 이미 최종 상태였다면 변경되지 않은 링크가 반환됩니다.

한 사용자를 위한 Bank Link의 실행 한 번입니다. 은행을 연결하거나 연결을 갱신합니다. 링크는 get_link로 직접 확인하십시오. 브라우저가 보낸 id는 절대 신뢰하지 마십시오.

id
string<uuid>
필수

링크의 ID입니다.

mode
enum<string>
필수
사용 가능한 옵션:
connect,
renew
access
enum<string>
필수
사용 가능한 옵션:
one_time,
ongoing
status
enum<string>
필수

링크의 상태입니다. completed, cancelled, expired, failed는 최종 상태입니다.

사용 가능한 옵션:
created,
opened,
connecting,
completed,
cancelled,
expired,
failed
url
string<uri> | null
필수

사용자를 안내할 호스팅 페이지입니다. 링크를 생성할 때만 반환되며, 토큰이 저장되지 않으므로 이후 조회에서는 null입니다.

client_token
string | null
필수

Didit의 임베디드 Bank Link용 토큰이며, 아직 출시되지 않았습니다. 현재는 url을 여십시오. 링크를 생성할 때만 반환되며, 이후 조회에서는 null입니다. 용도가 단일하고 수명이 짧습니다. 개인 데이터를 포함하지 않습니다. 절대 로그에 남기지 마십시오.

expires_at
string<date-time>
필수

사용되지 않은 링크가 작동을 멈추는 시점입니다.

connection_id
string<uuid> | null
필수

status가 completed일 때 이 링크로 생성되거나 갱신된 연결입니다.

check_id
string<uuid> | null
필수

이 링크에서 ownership.compare를 none 이외의 값으로 요청한 경우의 소유 구조 결과입니다.

reused
boolean
필수

사용자가 정확히 이 계정들을 이미 공유하고 있어서 링크가 기존 연결의 갱신으로 완료된 경우 true입니다(duplicates: reuse). 이중으로 요금이 청구되지 않습니다.

error
object | null
필수

status가 failed인 경우 링크가 실패한 이유입니다. 그렇지 않으면 null입니다.

quote
object
필수

링크 생성 시 고정되는 링크 가격입니다. 청구되는 금액은 견적의 금액입니다. 조회는 절대 과금되지 않습니다.

vendor_data
string | null
필수

요청에 있던 귀사의 참조 값입니다.

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