QueryString 변경 가능 옵션
1. Query String으로 전송 가능한 정보들
Query String으로 전송한 추가 정보는 API 호출 시 응답 데이터 값에 포함됩니다. API 호출 시 KYC 제출자 식별을 위한 고유 유저 ID를 생성할 수 있고, 커스텀 필드는 최대 3개까지 추가 가능합니다.
Query String 옵션은 Argos KYC 라이브폼과 API 모두에 적용할 수 있으며, 모든 쿼리 스트링 값은 URL에 인코딩 되어야 합니다.
기본 폼 URL
QueryString 포함 URL
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가지 모두 해당할 경우 ‘시간 만료’ 사유가 우선 함.
시간 만료
최초 사용으로부터 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 다운로드
기본 폼 URL
Token ID 포함 URL
token
{tokenId}
Private mode 에서, live-form 으로 제출 시 사용한 tokenID
3. 웹페이지 기본 언어 설정
라이브폼 웹페이지는 한국어, 영어, 중국어, 스페인어, 일본어, 포르투갈어, 베트남어, 러시아어 등의 17가지 언어를 지원합니다. 라이브폼 URL에 lang 파라미터를 추가해 노출되는 기본 언어를 설정할 수 있습니다.
만약 설정이 되어 있지 않다면 모바일에서는 기기의 설정 언어로, PC에서는 브라우저의 언어로 노출됩니다.
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"
예시에서 처럼 라이브폼 URL 뒤에 lang 파라미터를 삽입해 기본 언어를 설정해주세요.
Last updated