메인 콘텐츠로 건너뛰기
POST
curl
Didit의 Travel Rule 최종 사용자 링크 API는 사용자가 지갑 또는 거래 상대방을 선택할 수 있도록 링크를 발급하며, 기록된 이메일 주소로 이 링크를 보낼 수도 있습니다. {"channel": "link"}를 전송하면 링크가 복사되고, {"channel": "email"}을 전송하면 이메일 전송도 시도합니다. channel을 생략하면 기본값은 link입니다. 이메일은 최종 사용자의 Didit 기록에 있는 주소와, 사용 가능한 경우 인증 세션의 언어를 사용합니다. 임의의 수신자를 지정할 수는 없습니다. 이 API에는 거래에 대한 쓰기 권한과, AWAITING_COUNTERPARTY, COUNTERPARTY_VASP_NOT_FOUND, COUNTERPARTY_VASP_NOT_REACHABLE, UNCONFIRMED_OWNERSHIP 또는 ON_HOLD 상태의 아웃바운드 전송이 필요합니다. 그 밖의 상태에서는 409를 반환하며, 알 수 없는 거래이거나 전송이 없는 경우에는 404를 반환합니다. 응답에는 end_user_link, expires_at, emailed_to, email_available이 포함됩니다. 새 링크를 생성하면 해당 전송에 대해 이전에 열려 있던 최종 사용자 링크는 모두 폐기됩니다. 링크는 의도한 최종 사용자에게만 공유하십시오. 기록된 이메일이 없으면 channel: email 요청은 code: end_user_email_missing과 함께 409를 반환합니다. 이 경우 channel: link로 요청하십시오. 이메일 전송에 실패하더라도 API는 사용 가능한 링크를 반환하며, 이때 emailed_to는 빈 값입니다. email_available은 주소가 존재한다는 뜻이며, 전송이 성공했다는 의미가 아닙니다. 사용자가 생성 시점에 명시적으로 선택하는 방식은 거래 생성과 Travel Rule 가이드를 참고하십시오. 전송 작업은 전송 업데이트를 참고하십시오.

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

경로 매개변수

transaction_id
string<uuid>
필수

해당 이체를 소유한 Didit 고유 거래 UUID입니다.

본문

application/json
channel
enum<string>
기본값:link

link는 새 링크를 반환합니다. email은 링크를 최종 사용자의 Didit 기록 이메일로도 전송을 시도합니다.

사용 가능한 옵션:
link,
email

응답

성공 응답입니다.

새 최종 사용자 링크입니다. 이 송금에 대해 이전에 열려 있던 링크는 모두 취소됩니다.

expires_at
string<date-time>
필수

링크 만료 시각입니다.

emailed_to
string
필수

전송이 성공한 경우 수신자, 그렇지 않으면 빈 문자열. 이메일 전송이 실패해도 사용 가능한 링크는 반환됩니다.

email_available
boolean
필수

최종 사용자의 Didit 레코드에 이메일이 있는지 여부입니다.

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