Manage KYC data
Review, approve, reject, or request updates to user KYC submissions as an Identity Manager.
This guide explains how Identity Managers review and manage KYC (Know Your Customer) submissions from users. Managing KYC data is a prerequisite step before issuing on-chain KYC verifications.
Prerequisites
- Identity Manager role or equivalent permissions
- Understanding of your organization's KYC requirements
- Access to the Participants section
About KYC management
Users complete their KYC profiles with personal information and supporting documents, then submit for review. As an Identity Manager, you review these submissions and take one of three actions:
| Action | When to use | Result |
|---|---|---|
| Approve | All information is correct and complete | User profile is approved, ready for verification |
| Reject | Submission has fundamental issues | User must correct and resubmit |
| Request update | Minor issues or additional information needed | New draft created with your feedback for user |
Reviewing KYC submissions
Access user KYC data
Navigate to Participants > Users and select a user. On the user detail page, find the KYC section in the sidebar or click the KYC status tile.
View submission details
The KYC detail page shows all version history for the user. Click any row to open the version details sheet showing:
- Personal information (name, date of birth, country, residency status, national ID)
- Uploaded documents with download links
- Submission timestamp and status
- Previous review notes or rejection reasons

Review documents
Download and examine each uploaded document. Verify that:
- Documents are legible and complete
- Information matches the form fields
- Documents are current (not expired)
- Document types match requirements (government ID, proof of address)
Take action
Based on your review, choose one of the three actions available in the version detail sheet.
Approving submissions
When a submission meets all requirements:
Open approval dialog
Click Approve in the version detail sheet. The approval dialog opens.
Add optional notes
Enter any internal notes about the approval. These notes are stored for audit purposes. Note: Depending on your organization's configuration, these notes may be visible to the user, so avoid including sensitive internal information.
Confirm approval
Click Approve to confirm. The submission status changes to Approved and the user can proceed to receive on-chain verifications.
After approval, follow Verify KYC to issue the on-chain KYC verification.
Rejecting submissions
When a submission has fundamental issues that require complete correction:
Open rejection dialog
Click Reject in the version detail sheet. The rejection dialog opens.
Provide rejection reason
Enter a clear explanation of why the submission is rejected. This message is shown to the user, so be specific about what needs to change. Minimum 10 characters required.
Example reasons:
- "Document is expired. Please upload a current passport or national ID."
- "Name on document does not match the name entered in the form."
- "Proof of address document is illegible. Please provide a clearer scan."
Confirm rejection
Click Reject to confirm. The submission status changes to Rejected and the user sees your feedback on their profile page.
Requesting updates
When minor corrections or additional information are needed without fully rejecting the submission:
Open update request dialog
Click Request update in the version detail sheet. The update request dialog opens.
Describe required changes
Enter a clear message explaining what the user needs to update or provide. Minimum 10 characters required.
Example requests:
- "Please add a proof of address document (utility bill or bank statement from the last 3 months)."
- "Date of birth appears incorrect. Please verify and update."
- "Please upload the second page of your passport showing the signature."
Submit request
Click Request update to confirm. A new draft version is created for the user with your feedback displayed. The user can edit and resubmit.
Version history
The KYC detail page shows the complete version history for each user:
| Column | Description |
|---|---|
| Version | Sequential version number |
| Status | Current status (draft, submitted, approved) |
| Submitted | When the version was submitted for review |
| Reviewed | When and by whom the version was reviewed |
Click any row to view full details including documents and review notes.
Integration with verification workflow
KYC data management is part of the broader user onboarding workflow:
- User completes onboarding - Creates wallet and on-chain identity
- User provides KYC data - Fills profile and uploads documents
- Identity Manager reviews - Approves, rejects, or requests updates (this guide)
- Identity Manager registers user - Adds user to identity registry
- Identity Manager verifies KYC - Issues on-chain verification
See Onboarding runbook for the complete workflow.
Best practices
Review consistency
- Apply the same standards to all submissions
- Document your organization's specific requirements
- Consult with compliance team for edge cases
Clear communication
- Provide specific, actionable feedback
- Reference exact documents or fields that need attention
- Explain why information is insufficient, not just that it is
Timely processing
- Review submissions promptly to avoid delays
- Use request update for minor issues rather than full rejection
- Batch similar reviews when possible for efficiency
Audit trail
- Add notes to approvals explaining verification steps taken
- Keep records of document verification methods
- Maintain consistent documentation standards
Troubleshooting
| Issue | Solution |
|---|---|
| Cannot see KYC section | Verify you have Identity Manager role with KYC read permissions |
| Cannot download documents | Check browser permissions for downloads. Try a different browser if issues persist. |
| Approve/Reject buttons disabled | Only submitted or under review versions can be actioned. Draft versions must be submitted by the user first. |
| User not receiving feedback | Confirm the action completed successfully. Check user can access their profile page. |
| Cannot find user submission | Use the search function in Participants. Verify the user has submitted (not just saved a draft). |
Related guides
- Provide KYC Data - How users complete their KYC profile
- Register User - Register users in the identity registry
- Verify KYC - Issue on-chain KYC verifications after approval
- Onboarding Runbook - Complete user onboarding workflow
- Configure Trusted Issuers - Set up verification permissions