메인 콘텐츠로 건너뛰기
Didit의 Bank Link는 사용자가 절차를 마치면, 링크에 Didit이 허용하는 redirect_url이 포함되어 있을 경우 사용자를 귀사의 사이트로 돌려보냅니다. 이것이 없으면 사용자는 Didit의 결과 페이지에서 절차를 마치며, 귀사는 bank.link.completed webhook이나 링크 조회를 통해 결과를 확인하게 됩니다.

현재 사용할 수 있는 주소

샌드박스 애플리케이션에서는 localhost, 127.0.0.1 또는 [::1]의 일반 http 주소(포트, 경로는 자유롭게 지정할 수 있으며 자격 증명과 프래그먼트는 없어야 합니다)를 등록 없이 redirect_url로 사용할 수 있습니다. 그 밖의 주소는 링크를 생성할 때 400 redirect_url_not_registered 오류와 함께 거부됩니다. 다른 반환 주소를 등록하는 기능은 아직 제공되지 않습니다.

리디렉션 URL로 링크 생성

링크 연결이 완료되면 마지막 화면이 표시된 뒤 몇 초 후에 브라우저가 redirect_url로 자동 이동하며, 이때 link_id, status, 서명된 state가 함께 전달됩니다. 사용자가 취소하거나 거부하면 Didit의 결과 페이지에 머무르며, 이 페이지에는 status=failed를 포함하여 귀사의 주소로 돌아가는 버튼이 있습니다. 페이지를 표시할 때 이 파라미터를 사용하되, 화면 표시 용도로만 사용하십시오. 최종 기준은 webhook과 GET /v3/bank/links/{id}/입니다.

서버에서 항상 확인하십시오

브라우저가 무엇을 알려 주든, 해당 사용자에게 저장해 둔 링크 ID를 사용해 GET /v3/bank/links/{id}/로 조회하거나 bank.link.completed webhook으로 확인하십시오.

관련 문서

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