> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Bank Link 리디렉션 URL: 사이트로 돌아가기

> Bank Link 후 redirect_url로 사용자를 사이트에 되돌려 보내세요. 샌드박스에서는 localhost 주소를 쓸 수 있으며, 없으면 Didit 결과 페이지에서 끝납니다.

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로 링크 생성

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{
    "access": "one_time",
    "country": "ESP",
    "redirect_url": "http://localhost:3000/bank/return",
    "vendor_data": "client-7731"
  }'
```

링크 연결이 완료되면 마지막 화면이 표시된 뒤 몇 초 후에 브라우저가 `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으로 확인하십시오.

## 관련 문서

* [호스팅된 Bank Link](https://docs.didit.me/ko/integration/bank-link/hosted-link.md)
* [빠른 시작](https://docs.didit.me/ko/core-technology/bank-verification/quickstart.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.