Overview
Our hosted solution is a secure, fully customizable, hosted KYC and identity verification page that enables you to verify your clients quickly without any code. The hosted onboarding page is the fastest way to get started with KYC verification.Mobile-Responsive Design: The hosted page is fully responsive and optimized for all devices (desktop, tablet, and mobile). Your users will have a seamless verification experience regardless of the device they use.
How It Works
Customization Parameters
You can customize the onboarding page using these parameters:Branding & Visual Customization
The web page can be hosted on your own domain
The default page language. Supported values:
en, es, ptThe page icon (favicon)
The main logo displayed on the page
Color Customization
All color parameters accept hex color codes (e.g.,#6366f1):
Hex code for the headers color
Hex code for the paragraphs color
Hex code for the support texts color
Hex code for the background color
Hex code for the pills color
Hex code for the progress bar color
Hex code for the primary button color
Hex code for the secondary button color
Hex code for the selector color
Hex code for the primary button text color
Hex code for the secondary button text color
Web border radius. Number between 0 and 50
Validation Rules Configuration
You can customize the validation rules using these parameters:Age Verification
Decline automatically all sessions performed by users under a certain age. Number between 1 and 100
Document Capture
Select allowed methods for images:
Camera- Only camera captureUpload- Only file uploadBoth- Allow both methods
Duplicate Detection
When a user has previously approved documents from the same application, you can set an automatic rule on how to proceed:
Approve- Automatically approveReview- Send to manual reviewDecline- Automatically decline
Document Validation Rules
If a barcode or QR code was expected in the document but couldn’t be read, you can set an automatic rule:
Approve- Automatically approveReview- Send to manual reviewDecline- Automatically decline
When a Machine-Readable Zone (MRZ) is expected in the document but cannot be read:
Approve- Automatically approveReview- Send to manual reviewDecline- Automatically decline
When a document’s expiration date is expected but cannot be read or is in an invalid format:
Approve- Automatically approveReview- Send to manual reviewDecline- Automatically decline
This issue arises when we are unable to validate a date, detect a document number, or accurately recognize the document:
Review- Send to manual reviewDecline- Automatically decline
This issue arises when we are unable to validate document liveness:
Approve- Automatically approveReview- Send to manual reviewDecline- Automatically decline
This issue arises when the address on the document could not be found or geolocated, likely due to an invalid or missing address:
Approve- Automatically approveReview- Send to manual reviewDecline- Automatically decline
These validation parameters must be communicated to the Gu1 team through your dedicated support channel. If you need to make changes or modifications to these parameters, please submit a request via your dedicated client support channel. In the future, these parameters will be editable in the Gu1 dashboard.
How to Get the Onboarding Page URL?
Create a Person
First, create a person entity in Gu1 with your customer’s basic informationLearn how to create a person →
Create a Session
Create a KYC validation session for that personLearn how to create a validation →
Get the sessionUrl
Retrieve the
sessionUrl from the response. This is the hosted page URL you can share with your clientExample Implementation
Best Practices
Customize for Your Brand
Customize for Your Brand
Configure the color scheme, logo, and language to match your brand identity. This creates a seamless experience for your users.
Set Appropriate Validation Rules
Set Appropriate Validation Rules
Configure validation rules based on your compliance requirements and risk tolerance. More strict rules provide better security but may result in more manual reviews.
Monitor Session Status
Monitor Session Status
Use webhooks to receive real-time notifications when verification completes. This allows you to immediately update user access in your system.
Handle Expiration & Security
Handle Expiration & Security
Session Expiration: Sessions typically expire after 7 days. If a user’s session expires, create a new validation to generate a fresh URL.Security Best Practices:
- Never expose the sessionUrl publicly (don’t share in public forums, public URLs, etc.)
- Always generate URLs server-side - never expose API keys in client-side code
- Use HTTPS when sharing URLs via your own systems
- Implement proper authentication before generating sessions for users
- Consider implementing rate limiting on session creation to prevent abuse
- Store validation IDs in your database linked to user records for audit trails