Skip to content

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.

5 minutesUser featureSite owner, complianceVerified against the platform code

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

FieldNotes
First name, Last nameRequired
Middle Name (optional)
Issuing countryOf the document
Document typeID Card, Passport, Driver's License or Residence Permit

2. Upload photos

PhotoNeeded for
Front sideEvery document type
Back sideID cards and residence permits (passports and driving licences have no back side)
Selfie with documentEvery 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 ​

  1. In your Sumsub dashboard, create an App token and a verification level (for example basic-kyc-level).

  2. Add a webhook pointing to https://yourdomain.com/api/v1/sumsub/ipn, and copy its secret.

  3. Set in .env:

    ini
    SUMSUB_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-level
  4. Run 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 ​

StatusMeaning
Not VerifiedNothing 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 ​

FeatureWithout KYCWith KYC
Daily withdrawal limitThe no KYC limitThe KYC limit (General settings)
Buy crypto by cardNot allowedAllowed (Buy crypto)
Security level on the account pageMedium at mostCan reach High
P2P profileNo badgeVerified 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.

Owner documentation for the CryptoTech exchange platform.