QueryString changeable options

1. Information that can be transmitted through Query String

Additional information sent to Query String is included in the response data value when calling the API. When calling API, you can create a unique user ID for identifying KYC submitters, and up to 3 custom fields can be added.

The Query String option can be applied to both ARGOS ID check API and Liveform, and all query string values must be encoded in the URL.

Option	URL parameter
Basic form URL	https://form.argosidentity.com/?pid={project_Id}
URL with QueryString	https://form.argosidentity.com/?pid={project_Id}&blacklistCountries=false

Key	Description
blacklistCountries	Turn OFF options for blacklisted countries for the respective submission ('false' only possible).
approvePeriod	Turn OFF options for the approved duplicate submission prevention period for the respective submission ('false' only possible).
rejectPeriod	Turn OFF options for the rejected duplicate submission prevention period for the respective submission ('false' only possible).
ageLimit	Turn OFF options for age restrictions for the respective submission ('false' only possible).
rejectDuplicateUser	Turn ON/OFF options for duplicate submission prevention for the respective submission ('true' and 'false' both possible).
userid	User's custom unique identifier
pid	Unique separator for each project
sid	Unique separator for each submission
cf1	Custom Option Field #1
cf2	Custom Option Field #2
cf3	Custom Option Field #3

2. Information that can be transmitted with Token ID

1) Definition

• The Private Mode option is used, and random String data can be transmitted when submitting to Liveform.

2) Purpose

• To prevent sharing and duplicate use of the same Link (URL)

3) Token verification method

• Verification conditions are largely divided into the following two types, and if either one applies, verification failure (error) occurs.

• However, if both apply, the ‘time expiration’ reason takes precedence.

Case	Description
Time expiration	3 minutes after first use
There is a valid submission	If there is a submission whose KYC Status has already been determined (approved, rejected, pending)

• However, if the above two conditions are not met, multiple users can attempt/proceed with KYC with the same Token ID at the same time.

4) Check Token ID

• You can check the Token ID used for each submission through the three paths below.

i. Webhook

ii. GET Submission API (for single inquiry using submission_id)

iii. Download Submission CSV from Dashboard

Option	URL parameter
Basic form URL	https://form.argosidentity.com/?pid={project_Id}
URL with QueryString	https://form.argosidentity.com/?pid={project_Id}&token={tokenId}

Name	Value	Description
token	{tokenId}	TokenID used when submitting live-form in private mode

3. Webpage default language

The Live Form webpage supports 17 languages: Korean, English, Chinese, Spanish, Japanese, Portuguese, Vietnamese and Russian. You can set the default language exposed by adding lang parameters to the Liveform URL.

If it is not set up, it will be exposed as the default language of the device on mobile, browser language at 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

As the example shows, please set the default language by inserting the lang parameter after the Liveform URL.