QueryString 변경 가능 옵션

1. Query String으로 전송 가능한 정보들

Query String으로 전송한 추가 정보는 API 호출 시 응답 데이터 값에 포함됩니다. API 호출 시 KYC 제출자 식별을 위한 고유 유저 ID를 생성할 수 있고, 커스텀 필드는 최대 3개까지 추가 가능합니다.

Query String 옵션은 Argos KYC 라이브폼과 API 모두에 적용할 수 있으며, 모든 쿼리 스트링 값은 URL에 인코딩 되어야 합니다.

Option	URL parameter
기본 폼 URL	https://form.argosidentity.com/?pid={project_Id}
QueryString 포함 URL	https://form.argosidentity.com/?pid={project_Id}&blacklistCountries=false

Key	Description
blacklistCountries	블랙리스트 국가에 대한 옵션을 해당 submission 에 대하여 OFF 함 (’false’ 만 가능)
approvePeriod	Approved 중복 제출 방지 기간에 대한 옵션을 해당 submission 에 대하여 OFF 함 (’false’ 만 가능)
rejectPeriod	Rejected 중복 제출 방지 기간에 대한 옵션을 해당 submission 에 대하여 OFF 함 (’false’ 만 가능)
ageLimit	연령 제한에 대한 옵션을 해당 submission 에 대하여 OFF 함 (’false’ 만 가능)
rejectDuplicateUser	중복 제출 방지에 대한 옵션을 해당 submission 에 대하여 ON / OFF 함 (’true’ 및 ‘false’ 모두 가능)
userid	사용자의 사용자 지정 고유 식별자
pid	각각의 project 를 구분하는 고유의 구분자
sid	각각의 submission 을 구분하는 고유의 구분자
cf1	사용자 정의 옵션 필드1
cf2	사용자 정의 옵션 필드2
cf3	사용자 정의 옵션 필드3

2. Token ID 로 전송 가능한 정보들

1) 정의

• Private Mode 옵션을 사용하며, Liveform 으로 제출 시 함께 전송할 수 있는 임의의 String 데이터

2) 목적

• 동일한 Link (URL) 을 공유 및 중복 사용하는것을 방지하기 위함

3) Token 검증 방식

• 검증 조건은 크게 아래의 2가지로 구분되며, 둘 중 한 가지라도 해당할 경우 검증 실패(에러) 발생.

• 단, 2가지 모두 해당할 경우 ‘시간 만료’ 사유가 우선 함.

Case	Description
시간 만료	최초 사용으로부터 3분이 경과 시
유효한 제출 건이 존재	이미 KYC Status 가 결정된 제출건이 존재하는 경우 (approved, rejected, pending 중 )

• 단, 위 2가지 조건에 해당하지 않은 경우 동시에 여러 사용자가 동일한 Token ID 로 KYC 를 시도/진행 할 수 있음

4) Token ID 확인

• 아래의 3가지 경로를 통해, 각 Submission 별 사용된 Token ID 를 확인할 수 있음.

i. Webhook

ii. GET Submission API (submission_id 를 이용한 단 건 조회의 경우)

iii. 대시보드의 Submission CSV 다운로드

Option	URL parameter
기본 폼 URL	https://form.argosidentity.com/?pid={project_Id}
Token ID 포함 URL	https://form.argosidentity.com/?pid={project_Id}&token={tokenId}

Name	Value	Description
token	{tokenId}	Private mode 에서, live-form 으로 제출 시 사용한 tokenID

3. 웹페이지 기본 언어 설정

라이브폼 웹페이지는 한국어, 영어, 중국어, 스페인어, 일본어, 포르투갈어, 베트남어, 러시아어 등의 17가지 언어를 지원합니다. 라이브폼 URL에 lang 파라미터를 추가해 노출되는 기본 언어를 설정할 수 있습니다.

만약 설정이 되어 있지 않다면 모바일에서는 기기의 설정 언어로, PC에서는 브라우저의 언어로 노출됩니다.

Language	Code	Language	Code
Korean	"ko"	English	"en"
Chinese	"cn"	Spanish	"es"
Japanese	"jp"	Portuguese	"pt"
Vietnamese	"vn"	Russian	"ru"
Arabic	"ar"	Finnish	"fi"
French	"fr"	Hindi	"hi"
Indonesian	"id"	Persian	"pe"
Polish	"pl"	Thai	"th"
Turkish	"tr"

 https://form.argosidentity.com/?pid={project_Id}&lang=en

예시에서 처럼 라이브폼 URL 뒤에 lang 파라미터를 삽입해 기본 언어를 설정해주세요.