Sumsub Flow

When Sumsub is the active provider, tenants verify inside an embedded Sumsub iframe and results arrive automatically via webhook. For credential fields, see Landlord Setup.

What the Tenant Sees

1. Tenant clicks "Start KYC" → Sumsub SDK iframe loads
2. Tenant completes the verification steps inside the iframe:
   • Upload identity document (passport, national ID, etc.)
   • Take a selfie / liveness check
   • Complete any additional steps configured in your Sumsub level
3. Status changes to "Under Verification"
4. Sumsub reviews (automated + human review for edge cases)
5. Sumsub sends a webhook to your platform
6. Application status updates automatically

Webhook Setup

Add this URL in your Sumsub Dashboard → Developers → Webhooks:

https://your-platform-domain.com/kyc/sumsub/webhook

The webhook secret in your platform settings must match the secret in Sumsub, or status updates will not arrive.

Result Mapping

Token Refresh

If the SDK token expires during verification, the SDK automatically requests a fresh token from your platform. The merchant does not need to restart the process.

Troubleshooting

Sumsub iframe not loading?

• Your Sumsub App Token and Secret Key must be correctly entered in landlord Settings
• Check that the Level Name matches an existing level in your Sumsub dashboard
• Clear your browser cache and try again

Webhook not updating Sumsub status?

• Verify the webhook URL is correctly entered in your Sumsub dashboard
• The webhook secret in your platform settings must match the secret in Sumsub
• Check server logs for any incoming webhook errors

Application showing "Suspended" and cannot resubmit?

• Suspended status comes from Sumsub's FINAL rejection — this means the provider has permanently flagged the applicant
• Contact your platform provider for manual review