Sumsub Integration

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.

This ensures a seamless, automated workflow, so your compliance team always works with the most up-to-date verification information from Sumsub. The result: less manual duplication, fewer silos, and more time to focus on what matters — identifying risks faster and protecting your business and customers.

How It Works: A Simple, Automated Flow

The integration is designed to be seamless and work for you in the background. Here's a step-by-step look at how it operates:

Secure Connection

You start by securely linking your Sumsub account to Corsa. This is a one-time setup that authorizes Corsa to receive verification information from Sumsub on your behalf. All credentials are fully encrypted and securely stored.

Automatic Real-Time Syncing

Corsa receives real-time webhook notifications from Sumsub whenever new verifications are created or existing verifications are updated. These events are instantly processed and synced directly into your Corsa dashboard. No manual imports, no stale data — just one consistent source of truth with real-time updates from Sumsub.

Keeping Everything Up-to-Date

The integration ensures your verifications are always accurate and never duplicated:

New Verifications: When a new verification appears in Sumsub, it's automatically created in Corsa via webhook.
Updates: If a verification changes in Sumsub (e.g., review status or verification result), that update is instantly reflected in Corsa through real-time webhook notifications.

This real-time sync guarantees your Corsa dashboard always has the latest verification information from Sumsub, saving time and reducing errors.

Prerequisites

Before you begin, ensure that:

You have owner access to the Corsa application.
You have a Sumsub account with permission to generate API credentials and configure webhooks.

Setting Up the Chainalysis Integration

Navigate to Integration Settings
1. Log in to Corsa.
2. Go to Settings → Integrations.

Click on the Configure button to begin the configuration process
Enter Sumsub Credentials - you will need to:
1. Log in to your Sumsub account and navigate to the Dev space section.
2. Go to App tokens
3. Create a new API key:
  - Click "Generate app token" or "Add New Key"
  - Give your API key a descriptive name (e.g., "Corsa Integration")
  - Copy and save the following credentials:
    - API Token (also called App Token or Access Token)
    - API Secret Key (also called Secret Key or Access Secret) Important: Save these credentials securely. You'll need them in the next step. The secret key is only shown once when created.
4. Enter the credentials into Corsa
After saving, the webhook configuration will appear on the screen:
Configure the webhook with the values generated by Corsa - you will need to:
1. Navigate to Webhook manager in your Sumsub dashboard (usually under Dev space → Webhooks → Webhook manager).
2. Create a new webhook:
  - Click "Create Webhook"
  - Add an informative name (e.g., "Corsa Integration Webhook")
  - Enter your Corsa webhook URL:
    - Copy the webhook URL from the "Webhook Configuration"
    - Paste it into the webhook URL field in Sumsub
  - Select applicant types: Choose "All types" to receive events for both individual and company applicants
  - Set signature algorithm: Select SHA256 (HMAC_SHA256_HEX)
  - Enter your Corsa Secret Key:
    - Copy the webhook secret key from the "Webhook Configuration"
    - Paste it into the secret key field in Sumsub
  - Select the events you want to receive:
    - applicantCreated - When a new applicant is created
    - applicantPending - When an applicant is pending review
    - applicantAwaitingService - When an applicant is awaiting service
    - applicantOnHold - When an applicant is on hold
    - applicantAwaitingUser - When an applicant is awaiting user action
    - applicantReviewed - When an applicant review is completed
If the configuration was successful you should see it in an enabled status:

Viewing webhook configuration later: If you need to retrieve the webhook configuration later, you can click the "Webhook Config" button in the Corsa integration settings, or use the GET /integration-configuration/webhook-config API endpoint.