라이브폼 URL
쿼리 스트링 및 토큰
라이브폼의 QueryString 및 Token ID 옵션에 대한 종합 가이드입니다. API 호출 시 추가 정보 전송, 중복 제출 방지, 사용자 식별 등 다양한 기능을 제공합니다. ID Check 프로세스 최적화를 위한 필수 정보를 확인하세요.
1. QueryString 변경 가능 옵션
라이브폼과 API에서 사용 가능한 QueryString 옵션을 통해 추가 정보를 전송하고 KYC 프로세스를 커스터마이즈할 수 있습니다.
2. 기본 URL 구조
- 기본 폼 URL:
https://form.argosidentity.com/?pid={project_Id}
- QueryString 포함 URL:
https://form.argosidentity.com/?pid={project_Id}&blacklistCountries=false
2-1. 주요 QueryString 파라미터
파라미터 | 설명 |
---|---|
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 |
모든 쿼리 스트링 값은 URL에 인코딩되어야 합니다.
2-2. 고유 유저 ID 및 커스텀 필드
- API 호출 시 KYC 제출자 식별을 위한 고유 유저 ID를 생성할 수 있습니다.
- 최대 3개의 커스텀 필드(cf1, cf2, cf3)를 추가하여 추가 정보를 전송할 수 있습니다.
3. Token ID 옵션
tokenId는 Private Mode에서 Liveform 제출 시 사용되는 String 데이터입니다.
목적 : 동일한 URL의 공유 및 중복 사용 방지
3-1. Token 검증 방식
다음 조건 중 하나라도 해당되면 검증 실패(에러) 발생: 시간 만료: 최초 사용으로부터 3분 경과 유효한 제출 건 존재: KYC Status가 결정된 제출건 존재 (approved, rejected, pending)
주의
- 위 조건에 해당하지 않으면 여러 사용자가 동시에 동일한 Token ID로 KYC를 진행할 수 있습니다.
3-2. Token ID 확인 방법
- Webhook
- GET Submission API (submission_id를 이용한 단건 조회)
- 대시보드의 Submission CSV 다운로드
3-3. Token ID 사용 URL 구조
- 기본 폼 URL:
https://form.argosidentity.com/?pid={project_Id}
- Token ID 포함 URL:
https://form.argosidentity.com/?pid={project_Id}&token={tokenId}
이 가이드를 통해 ID Check의 QueryString 및 Token ID 옵션을 효과적으로 활용하여 KYC 프로세스를 최적화하고 사용자 경험을 개선할 수 있습니다
Was this page helpful?