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만 가능)
approvePeriodApproved 중복 제출 방지 기간에 대한 옵션을 해당 submission에 대하여 OFF 함 (false만 가능)
rejectPeriodRejected 중복 제출 방지 기간에 대한 옵션을 해당 submission에 대하여 OFF 함 (false만 가능)
ageLimit연령 제한에 대한 옵션을 해당 submission에 대하여 OFF 함 (false만 가능)
rejectDuplicateUser중복 제출 방지에 대한 옵션을 해당 submission에 대하여 ON / OFF 함 (truefalse 모두 가능)
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?