QueryString 변경 가능 옵션
1. Query String으로 전송 가능한 정보들
Query String으로 전송한 추가 정보는 API 호출 시 응답 데이터 값에 포함됩니다. API 호출 시 KYC 제출자 식별을 위한 고유 유저 ID를 생성할 수 있고, 커스텀 필드는 최대 3개까지 추가 가능합니다.
Query String 옵션은 Argos KYC 라이브폼과 API 모두에 적용할 수 있으며, 모든 쿼리 스트링 값은 URL에 인코딩 되어야 합니다.
Option | URL parameter |
---|---|
기본 폼 URL | |
QueryString 포함 URL |
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 | |
Token ID 포함 URL |
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" |
예시에서 처럼 라이브폼 URL 뒤에 lang 파라미터를 삽입해 기본 언어를 설정해주세요.
Last updated