SettleMint
User guidesCompliance

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:

ActionWhen to useResult
ApproveAll information is correct and completeUser profile is approved, ready for verification
RejectSubmission has fundamental issuesUser must correct and resubmit
Request updateMinor issues or additional information neededNew 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

KYC version detail sheet

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:

ColumnDescription
VersionSequential version number
StatusCurrent status (draft, submitted, approved)
SubmittedWhen the version was submitted for review
ReviewedWhen 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:

  1. User completes onboarding - Creates wallet and on-chain identity
  2. User provides KYC data - Fills profile and uploads documents
  3. Identity Manager reviews - Approves, rejects, or requests updates (this guide)
  4. Identity Manager registers user - Adds user to identity registry
  5. 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

IssueSolution
Cannot see KYC sectionVerify you have Identity Manager role with KYC read permissions
Cannot download documentsCheck browser permissions for downloads. Try a different browser if issues persist.
Approve/Reject buttons disabledOnly submitted or under review versions can be actioned. Draft versions must be submitted by the user first.
User not receiving feedbackConfirm the action completed successfully. Check user can access their profile page.
Cannot find user submissionUse the search function in Participants. Verify the user has submitted (not just saved a draft).

On this page