Appearance
Identity verification (KYC)
Users prove who they are by submitting an identity document and a selfie. You review them yourself in the admin panel, or let Sumsub do it automatically. Verified users get a higher withdrawal limit and can buy crypto by card.
Turning it on
KYC must be on in General settings → KYC. When it's off, the verification page says KYC Is Disabled ("KYC is disabled in the platform.").
Users open Identity Verification (/user/kyc) from their account, the security overview, or the home page banner "Verify your identity to unlock all features".
Built-in verification
With Sumsub off, users fill in a two-step form:
1. Personal details
| Field | Notes |
|---|---|
| First name, Last name | Required |
| Middle Name (optional) | |
| Issuing country | Of the document |
| Document type | ID Card, Passport, Driver's License or Residence Permit |
2. Upload photos
| Photo | Needed for |
|---|---|
| Front side | Every document type |
| Back side | ID cards and residence permits (passports and driving licences have no back side) |
| Selfie with document | Every document type |
Photos must be jpg or png, up to 1 MB, bright and clear, and uncut (all corners visible). Users are reminded: "Make sure your details match your document exactly before submitting." Then Submit for review.
Your team reviews each application in Admin → KYC and approves or rejects it with a reason.
Rules the server enforces (website and app):
- One submission at a time. While an application is under review, or once the user is verified, a new one is refused ("Your documents are already being reviewed" / "Your identity is already verified"). After a rejection the user can submit again.
- Own photos only. The front, back and selfie must be files the same user uploaded in the last 24 hours. This stops anyone submitting another user's uploaded documents.
- Submitting is refused while KYC is off in settings.
The mobile app has the same form under Account → Identity verification, with the camera or gallery for each photo, and shows the reviewer's rejection reason.
Sumsub verification
With Sumsub on, the form is replaced by Start verification: "You will be redirected to our verification partner to scan your document and take a selfie." Sumsub checks the document and face, then reports the result back to the platform automatically.
Setting up Sumsub
In your Sumsub dashboard, create an App token and a verification level (for example
basic-kyc-level).Add a webhook pointing to
https://yourdomain.com/api/v1/sumsub/ipn, and copy its secret.Set in
.env:iniSUMSUB_ENABLED=true SUMSUB_APP_TOKEN=your-app-token SUMSUB_APP_SECRET=your-secret-key SUMSUB_WEBHOOK_SECRET=your-webhook-secret SUMSUB_KYC_LEVEL=basic-kyc-levelRun
php artisan config:clear.
The webhook's signature is checked with SUMSUB_WEBHOOK_SECRET. When Sumsub's review answer is GREEN, the user becomes verified. Any other answer marks the application as rejected.
What users see
| Status | Meaning |
|---|---|
| Not Verified | Nothing submitted yet. Button: Start KYC. |
| Under review | "Your KYC request is being reviewed." "Once we verify your identity, the system will adjust your status." |
| Rejected | "Your KYC request was rejected. Please submit your documents again." The Reason from your reviewer is shown, and they get an email. |
| Verified | "You are verified user. Now you can deposit cryptocurrency and start trading." |
Verified users get a Verified badge, which P2P counterparties also see.
What verification unlocks
| Feature | Without KYC | With KYC |
|---|---|---|
| Daily withdrawal limit | The no KYC limit | The KYC limit (General settings) |
| Buy crypto by card | Not allowed | Allowed (Buy crypto) |
| Security level on the account page | Medium at most | Can reach High |
| P2P profile | No badge | Verified badge |
Deposits, trading, swaps, staking and P2P aren't blocked for unverified users. If your licence requires verification before trading, set the no KYC withdrawal limit very low, and tell users clearly in your Terms.
The page texts promise more
The verification page says KYC unlocks "deposits, withdrawals and higher limits". Only the withdrawal limit and card purchases are actually gated. Change the texts in Languages if you prefer to be exact.
Where documents are stored
Uploaded photos are saved in storage/app/public/uploads/ under random file names. Include that folder in your backups, and limit who can access the server.
