Skip to main content
The Sumsub integration connects your Sumsub account directly to the Corsa platform. All Know Your Customer (KYC) verification results and applicant data are automatically synced from Sumsub into your Corsa dashboard via real-time webhooks.

​
How It Works

  1. Secure Connection - Securely link your Sumsub account to Corsa. One-time setup with fully encrypted credential storage.
  2. Automatic Real-Time Syncing - Corsa receives real-time webhook notifications from Sumsub whenever verifications are created or updated.
  3. Keeping Everything Up-to-Date - Updates to verifications in Sumsub are instantly reflected in Corsa. New verifications are automatically created.

​
Prerequisites

  • A Sumsub account with permission to generate API credentials and configure webhooks.
  • Owner access to the Corsa application.

​
Setting Up the Sumsub Integration

​
Step 1: Create API Credentials in Sumsub

  1. Log in to your Sumsub account and navigate to Dev space → App tokens.
  2. Click Generate app token and give it a descriptive name (e.g., “Corsa Integration”).
  3. Copy and save the API Token and API Secret Key.
The secret key is only shown once when created. Save it securely.

​
Step 2: Configure in Corsa

  1. Log in to Corsa.
  2. Go to Developers Hub → Integrations.
  3. Click Configure on the Sumsub card.
  4. Enter the Sumsub credentials (API Token and Secret Key).

​
Step 3: Configure Automation Settings

  • Create alert on verification failure - Automatically create an alert when a verification fails. Select priority level.
  • Create alert when verification requires action - Automatically create an alert when a verification is on hold. Select priority level.
  • Auto-tag risk labels in client profile - Automatically apply risk labels from Sumsub as client tags in Corsa.

​
Step 4: Configure Webhook in Sumsub

After saving, Corsa generates a webhook configuration. In your Sumsub dashboard:
  1. Navigate to Dev space → Webhooks → Webhook manager.
  2. Click Create Webhook and add a name (e.g., “Corsa Integration Webhook”).
  3. Paste the webhook URL from Corsa.
  4. Set signature algorithm to SHA256 (HMAC_SHA256_HEX).
  5. Enter the webhook secret key from Corsa.
  6. Select applicant types: All types.
  7. Enable the following events: applicantCreated, applicantPending, applicantAwaitingService, applicantOnHold, applicantAwaitingUser, applicantReviewed.

​
Historical Verification Import

Corsa can import historical verifications from Sumsub. Add the Sumsub Applicant ID to the client record in Corsa, then go to Settings → Integrations → Sumsub and click Trigger Full Sync. What Gets Imported:
  • Applicant verification data and results
  • Review statuses and decisions
  • All associated verification documents and checks

​
Automatic Client Matching

When a new verification is received via webhook:
  • Matching client exists: Updated with the latest verification data.
  • No matching client: A new client is automatically created in Corsa.
New clients from Sumsub don’t need to be pre-created in Corsa - they will be created automatically when their first verification is received.
Corsa offers native integrations with leading compliance, blockchain analytics, and custody providers. See all integrations or schedule a demo to see how Corsa fits into your stack.