> ## 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.

# Finnish Trust Network(FTN) 연동 가이드

> Didit으로 핀란드 Finnish Trust Network(FTN) 신분증 인증을 설정하세요. 은행 로그인, 워크플로 구성, 검증 결과, 문서 대체 수단을 지원합니다.

Finnish Trust Network (FTN)을 통해 적격 사용자는 핀란드 은행의 신원 인증 수단 또는 지원되는 모바일 인증서로 신원을 인증할 수 있습니다.
워크플로 없이 자체 애플리케이션에서 직접 은행 인증을 시작하려면 [Finnish Trust Network API](https://docs.didit.me/ko/api-reference/digital-id-wallets/ftn.md)를 사용하세요.
또한 FTN은 지갑 식별자 `ftn`과 국가 코드 `FIN`을 사용하여 Didit의 **신분증 인증** 워크플로 단계 내에서도 실행됩니다.
아래에 설명된 호스팅 연동의 경우, 다른 Didit 워크플로와 동일한 세션 생성, 세션 결과 및 webhook을 사용하세요.

> [!NOTE]
>
> **Finnish Trust Network는 핀란드에서 사용할 수 있습니다.**
> `FIN`에 대해 워크플로의 허용된 지갑에서 `ftn`을 활성화하세요.
> 공개된 가격은 **완료된 인증 건당 \$0.25**입니다.
> 지원되는 모든 지갑에 대한 정보는 [지갑 지원 범위 및 요금](https://docs.didit.me/ko/core-technology/id-verification/digital-id-wallets.md#요금)을 참조하세요.

## 사용자 여정

1. 사용자는 워크플로에서 허용하는 신원 확인 수단 중 핀란드와 Finnish Trust Network를 선택합니다.
2. 참여 은행 또는 지원되는 모바일 인증서를 선택합니다.
3. 해당 서비스에서 인증을 진행하고 신원 확인을 승인합니다.
4. 사용자가 Didit 세션으로 돌아오면, 신원 결과를 검증하고 워크플로를 계속 진행합니다.

사용자는 선택한 서비스에 등록된 유효한 신원과 해당 인증 방식에 대한 접근 권한이 있어야 합니다.
은행 자격 증명 및 승인 코드는 해당 서비스의 자체 인증 화면에서만 입력합니다.
Didit은 자체 인증 양식에서 은행 비밀번호를 요구하지 않습니다.

Didit 수단 선택 화면 및 복귀 화면에는 세션의 브랜딩 및 맞춤 도메인 설정이 적용됩니다.
선택한 은행 또는 신원 확인 서비스가 자체 인증 화면을 제어합니다.

## 워크플로 구성

콘솔에서 워크플로의 **신분증 인증** 단계를 열고, **국가**를 선택한 후 **핀란드**를 엽니다.
**허용된 지갑**에서 지원되는 경우 Finnish Trust Network를 활성화합니다.
사용자가 대신 문서를 사용할 수 있도록 하려면 문서 인증을 활성화된 상태로 유지하세요.
새 세션을 생성하기 전에 워크플로를 저장하고 게시하세요.

다음은 전체 워크플로 요청이 아닌 `methods` 구성의 일부입니다.

```json theme={null}
{
  "FIN": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["ftn"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

사용할 수 없는 지갑을 지정하면 워크플로 저장이 거부됩니다.
전체 API 규격은 [워크플로 기능 구성](https://docs.didit.me/ko/management-api/workflows/feature-configs.md#ocr-/-신분증-인증)을, 시각적 설정 방법은 [콘솔 구성](https://docs.didit.me/ko/console/id-verification-methods.md)을 참조하세요.

## 검증된 결과

완료된 FTN 검사는 `cryptographic` 보증 수준을 갖춘 지갑 인증 결과를 반환합니다.
선택한 신원 확인 수단에서 반환하는 경우, 검증된 신원에는 사용자의 성명, 생년월일 및 개인 식별자가 포함됩니다.
FTN은 인물 사진을 반환하지 않습니다.
모든 선택적 신원 필드가 반드시 존재한다고 가정하지 말고 실제 결과를 확인하세요.

세션의 **자격 증명** 카드에는 선택한 지갑 및 검증된 증거가 표시됩니다.
결과 스키마에 대해서는 [신분증 인증 데이터 모델](https://docs.didit.me/ko/reference/data-models.md#신분증-인증)을 참조하세요.
성공적인 FTN 인증은 신분증 인증 단계를 완료하며, 나머지 검사에 따라 세션의 최종 결정이 내려집니다.
워크플로에 필요한 경우 별도의 라이브니스 감지 및 얼굴 대조 단계를 구성해 두세요.

## 취소 및 문서 대체

사용자가 취소하거나, 요청이 만료되거나, 인증에 실패하는 경우 Didit은 해당 국가의 `wallet.on_failure` 설정을 적용합니다.
`fallback_to_document`는 핀란드에서 문서 인증이 활성화되어 있을 때 문서 촬영을 시작합니다.
`decline`은 신분증 인증 단계를 거부 처리합니다.
비활성화된 문서 수단은 대체 수단으로 작동할 수 없습니다.
사용자를 Finnish Trust Network로 먼저 안내하고 실패한 경우에만 문서 촬영을 표시하려면 `document.fallback_only`를 `true`로 설정하세요.
[문서 촬영을 대체 수단으로만 제공하기](https://docs.didit.me/ko/core-technology/id-verification/verification-methods.md#대체-수단으로만-신분증-촬영-제공)를 참조하세요.

단순 리디렉션이나 은행 선택 화면 표시가 성공적인 신원 인증을 의미하지는 않습니다.
접근 권한을 부여하기 전에 검증된 세션 결과 또는 webhook을 기다리세요.
연동의 다른 부분과 마찬가지로 멱등성을 보장하는 동일한 처리를 통해 중복 webhook 전송을 처리하세요.

## 테스트 및 출시

지갑이 활성화된 환경에서 지갑을 테스트하세요.
성공적인 복귀, 사용자 취소, 만료, 불완전한 신원 정보 및 문서 대체를 모두 다루어야 합니다.
또한 사용자가 사용하는 기기 및 브라우저 환경에서도 테스트하세요.
시뮬레이션된 샌드박스 결과가 실제 은행 인증이나 프로덕션 활성화를 입증하지는 않습니다.

FTN의 공개 기본 요금은 **완료된 인증 건당 \$0.25**입니다.
취소, 만료 및 실패한 지갑 시도에는 완료된 지갑 인증 요금이 부과되지 않습니다.
완료된 문서 대체 인증은 문서 인증 요금에 따라 별도로 청구됩니다.
현재 결제 규칙에 대해서는 [지갑 요금](https://docs.didit.me/ko/core-technology/id-verification/digital-id-wallets.md#요금)을 참조하세요.

## 관련 가이드

* [디지털 ID 지갑 지원 범위 및 요금](https://docs.didit.me/ko/core-technology/id-verification/digital-id-wallets.md)
* [Smart-ID 및 Mobile-ID 연동](https://docs.didit.me/ko/core-technology/id-verification/smart-id-mobile-id.md)
* [신분증 인증 수단](https://docs.didit.me/ko/core-technology/id-verification/verification-methods.md)
* [webhook 연동](https://docs.didit.me/ko/integration/webhooks.md)


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