ID check requires not only dashboard configuration but also API integration. This page provides comprehensive guidance on dashboard setup, API usage for different scenarios, webhook utilization, and liveform integration.Documentation Index
Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
Use this file to discover all available pages before exploring further.
New Dashboard vs Old Dashboard Comparison
ID Check Best Experience Guide
A step-by-step setup guide for new customers. Follow the steps below to build an operational eKYC pipeline within a day.5 Representative Scenarios
1) Financial/PG Onboarding (Identity Verification + High Security)
1) Financial/PG Onboarding (Identity Verification + High Security)
- Project Status: TEST → OPEN transition
- Security Settings: Private mode + Token ID pre-registration + Encryption-only mode
- Authentication Policy: ARGOS Score 80~85, duplicate user detection
- Anti-Fraud: Streaming capture only, Proxy & VPN detection
2) Global Platform (Regional Regulations/ID Diversity)
2) Global Platform (Regional Regulations/ID Diversity)
- Projects: Managed separately by region
- Authentication Policy: Universal ID support, country-specific restrictions
- Anti-Fraud: Regional pre-screening, issuing country verification
- Security Settings: Regional access control via IP whitelist
3) Commerce/Marketplace (Fake Accounts/Multi-Account Prevention)
3) Commerce/Marketplace (Fake Accounts/Multi-Account Prevention)
- Authentication Policy: Face duplicate check enabled (Selfie process required)
- Anti-Fraud: Streaming capture only, Proxy & VPN detection
- Submission Limiting: Window Sliding method for submission rate limiting
- Duplicate Management: Duplicate check pipeline, duplicate approval/rejection prevention periods
4) Gaming/Adult Content (Age/Region Restrictions)
4) Gaming/Adult Content (Age/Region Restrictions)
- Authentication Policy: Age limits, blacklist countries, automatic processing only
- Anti-Fraud: Face-based age verification, regional pre-screening
- Submission Limiting: Force block feature to block abusive users
- Reviewer: ARGOS professional reviewers or Client API selection
5) Recruitment/Insurance/High-Risk Customer Screening (EDD)
5) Recruitment/Insurance/High-Risk Customer Screening (EDD)
- Additional Info: Up to 5 custom fields in Liveform step 2 (Text/Dropdown/Date/Phone/PDF upload)
- Authentication Policy: Custom ARGOS Score + Client API review
- Anti-Fraud: Multi-factor authentication (Government data verification, 1-won account verification, etc.)
- AML: Watch list filtering + Ongoing Monitoring
Step-by-Step Setup Guide
1. Project Basic Information Setup
- Project Name: Enter an accurate service name that users can recognize
- Project Logo: Upload a logo to distinguish projects in the dashboard
- Project Status: TEST during setup, OPEN when transitioning to production
- Liveform URL Check: Verify ID document / Knowledge-based pipeline URLs
Project Info Settings
2. Security and Access Control Setup
- Access Control: Private mode + Token ID pre-registration + Token expiration conditions
- Data Protection: Liveform encryption settings (ECB/GCM) + Encryption-only mode
- Secure Data Transfer: All data encrypted when calling APIs
Access Control
Data Protection
3. KYC Process and Authentication Policy Setup
- ARGOS Score Threshold: Higher scores mean stricter approval criteria (Recommended: Start with 80~85)
- Automatic Processing Only: 100% automated operation without Pending
- Age Limit: Automatic rejection for users below the set age
- Blacklist Countries: Restrict IDs issued from specific countries
KYC Process
4. Authentication Data and Duplicate Management
- Duplicate Check Pipeline: Choose baseline method or custom DI
- Submission Rate Limiting: Limit submission frequency using Window Sliding method
- Duplicate Approval/Rejection Prevention Period: Prevent re-submission from already processed users
Authentication Data
5. Authentication Enhancement and Anti-Fraud Setup
- ID Forgery Prevention: MRZ check, PDF417 check, ID liveness
- Face Authentication: Selfie process, face duplicate check, selfie liveness
- Meta Information-Based Detection: Proxy & VPN detection, regional pre-screening
- 3rd Party Data Sources: 1-won account verification, government data verification, etc.
Anti-Fraud and Forgery Prevention
6. AML (Anti-Money Laundering) Setup
- AML Watch list filtering: Set risk threshold, full date of birth match option
- AML Ongoing Monitoring: Continuous monitoring through periodic re-screening
AML Settings
7. Integration Info and Webhook Setup
- Webhook URL: HTTP POST to endpoint URL
- Notification User Management: Set up daily webhook report email reception
- Return URL: Set redirect URL after authentication completion
- Dynamic Fields: Pass kycStatus, userid, email, submissionId, etc.
- Return URL Encryption: Encrypt dynamic fields for transmission
Integration Info
8. Legal Notices and Additional Info Collection
- Legal Notices: Set Terms of Service URL, Privacy Policy URL
- Additional Info Collection: Up to 5 custom fields (Text/Dropdown/Date/Phone/PDF/Checkbox)
Additional Info
9. System Operation Settings
- Submission Control System: Emergency stop feature to halt all submissions
- Personal Information Display: Blur personal information in the dashboard
- Administrator Settings: Add/remove administrators, view login records
- Reviewer Settings: Choose ARGOS professional reviewers or Client API
- IP Whitelist: Allow dashboard and API access only from specified IPs
System Operation
API Integration Guide
The dashboard is a configuration tool for enabling options, while actual operations are performed through APIs. Check the API usage methods for each scenario.Scenario-Based API Usage Guide
Retrieve Customer Information
Retrieve Customer Information
GET /submissionUsage Methods:- Query by Submission ID: Check detailed information of a specific submission
- Query by User ID: Retrieve all submissions for a specific user
- Query by Email: Retrieve submissions by email address
- Query by Date Range: Retrieve submission list by date range
GET Submission API
Input Existing Customer Information
Input Existing Customer Information
POST /submission/migrationUsage Methods:- Migrate user data from existing systems to ARGOS system
- Generate sample data for test scenarios
- Direct data submission in special situations
POST Submission API
Manage Token ID
Manage Token ID
POST /token, GET /token, DELETE /tokenUsage Methods:- Token ID Pre-registration: Register up to 100,000 tokens using
POST /token - Token ID Query: Check registered token list and status using
GET /token - Token ID Deletion: Delete expired or unnecessary tokens using
DELETE /token
POST Token
GET Token
DELETE Token
Update Submission Status
Update Submission Status
PATCH /submission, POST /client-reviewUsage Methods:- Update Submission: Modify submission information using
PATCH /submission - Client Review: Process approval/rejection using
POST /client-review
PATCH Submission API
Webhook Utilization Guide
You can monitor and automate all stages of the KYC process in real-time through webhooks.Webhook Event Types
| Webhook Trigger | When It Occurs | Usage Example |
|---|---|---|
created | When a submission is created | Submission start notification, progress tracking |
submit | When a submission is in Pending status | Manual review required notification, assign to reviewer |
approved | When a submission is approved | Account activation, service access grant, approval notification |
rejected | When a submission is rejected | Rejection reason delivery, retry guidance |
updated | When a submission is updated | Status change tracking, log recording |
retry | When a retry occurs | Retry notification, user guidance |
delete | When a submission is deleted | Deletion log recording, data cleanup |
token_expired | When a Token ID expires | Token reissuance, access blocking |
injection | When injection is performed | Additional info collection completion notification |
aml | When AML search is completed | High-risk person detection notification, additional review needed |
aml_monitor | When AML Ongoing Monitoring results are available | Continuous monitoring result notification |
Webhook Setup Method
-
Set Webhook URL in Dashboard
- Enter webhook URL in Project Management > Project Settings > Integration Info
- HTTPS protocol required
-
Process Webhook Event Reception
-
Webhook Security Settings
- Signature verification implementation recommended
- IP Whitelist:
52.78.194.237must be allowed
Webhook Event Guide
Liveform Query String Utilization
You can pre-fill user information or customize the process by adding Query Strings to the Liveform URL.Basic Query String Parameters
| Parameter | Description | Example |
|---|---|---|
pid | Project ID (required) | pid=proj_abc123 |
email | User email | email=user@example.com |
userid | Internal user ID | userid=user_12345 |
cf1, cf2, cf3 | Custom fields | cf1=campaign_summer&cf2=source_web |
tokenid | Token ID (required for private mode) | tokenid=tok_abc123 |
sid | Submission ID (for injection) | sid=sub_abc123&action=addveri |
Query String Usage Examples
Using Encrypted Query Strings
If you enable Encryption-only mode in the dashboard, all Query Strings must be encrypted.Query String Guide
Re-verification and Add-on Utilization
You can use Add-on APIs when re-verification is needed for authenticated users.Face Auth API (Face Authentication Re-verification)
Scenario: When you want to re-verify face authentication for an already authenticated user APIs to Use:POST /faceauth, GET /faceauth, DELETE /faceauth
Face Auth API
Using Multiple Projects Simultaneously
When operating multiple projects simultaneously, you must use separate API Keys and settings for each project.Project-Specific API Key Management
Project-Specific Webhook Processing
- Each project has an independent API Key
- You can set different webhook URLs for each project
- Check and manage project-specific settings in the dashboard
Recommended Defaults (First Operation Baseline)
Security
- Private mode ON
- Token ID pre-registration ON (1-time expiration)
- Encryption-only mode ON
- IP whitelist registration
Policy
- ARGOS Score 80~85 start → adjust based on metrics
- Duplicate check pipeline ON
- Client API reviewer designation when needed
Anti-Fraud
- Selfie liveness ≥85
- Streaming capture only
- Proxy & VPN detection ON
- MRZ·PDF417 check ON
UX
- Skip result page if unnecessary
- Use encrypted Dynamic Fields
Common Issues and Solutions
I want to redirect to our service immediately after authentication
I want to redirect to our service immediately after authentication
- Set Return URL in Project Management > Project Settings > Integration Info
- Enable Skip result page option
- Safely pass required parameters via Dynamic Fields (can be encrypted)
Webhook notifications are not arriving
Webhook notifications are not arriving
- Verify endpoint URL accuracy
- Check HTTPS/signature verification implementation
- Verify firewall allows webhook IP address
52.78.194.237 - Check test event reception
Face duplicate check option is not working
Face duplicate check option is not working
- Selfie process activation is a prerequisite
- First enable selfie process in Project Management > Policy and Authentication > Anti-Fraud and Forgery Prevention
- Adjust selfie threshold appropriately
I can't find features I used in the old dashboard
I can't find features I used in the old dashboard
- Check option location changes in the New Dashboard vs Old Dashboard Comparison page
- Most features have moved under the Project Management section
- Use the search function at the top of the dashboard