Quick Start
To connect ComplyAdvantage to Corsa:- In ComplyAdvantage Mesh, create an API credential with the permissions listed below and copy the access key and secret.
- In Corsa, go to Developers Hub → Integrations → ComplyAdvantage.
- On the Connect screen, paste the access key and secret, choose your region, and save.
- On the Complete Setup screen, choose the case stage for each outcome and save.
- Optionally, contact ComplyAdvantage support to get your webhook signing secret, then add it so new alerts arrive within seconds.
- Open the Health section on the integration card and confirm the backfill runs.
How It Works
- Secure Connection - Corsa checks your ComplyAdvantage credential and region, then stores it encrypted.
- Alert Sync - Corsa imports open alerts from the last 30 days by default, then picks up new and changed alerts on every check. With a webhook signing secret, new alerts arrive within seconds.
- Client Linking - Corsa links each alert to the matching Corsa client, or creates one when nothing matches.
- Two-Way Decisions - Match decisions and notes made in Corsa are written to ComplyAdvantage, and decisions and notes made in ComplyAdvantage are copied to Corsa.
- Case Closure - When every alert of a ComplyAdvantage case has ended, Corsa moves the case to the stage you mapped for its outcome.
What Gets Synced
Case types
Corsa syncs customer onboarding and customer monitoring cases. Payment screening and transaction monitoring cases are not synced.Alerts and screening matches
- One ComplyAdvantage alert becomes one Corsa alert, with a link back to the alert in ComplyAdvantage.
- Each ComplyAdvantage risk becomes a screening match on that alert.
- Match notes include the matched listings, PEP details, media articles, why the customer matched and, for monitoring alerts, what changed since the last screening.
- When a risk disappears after a re-screen, Corsa keeps the match and adds a note to it.
- ComplyAdvantage case ID
- ComplyAdvantage case type (Onboarding or Monitoring)
- ComplyAdvantage alert type
Priority mapping
Decisions and notes
Pending and escalated decisions in Corsa are not sent to ComplyAdvantage. Note edits and deletions are not synced in either direction.
ComplyAdvantage ends an alert by itself once all its risks are decided. If you resolve a Corsa alert while matches are still undecided, Corsa adds a note in ComplyAdvantage and the alert stays open there.
Case closure
When every alert of a ComplyAdvantage case has ended, in either system, Corsa moves the case to the stage you mapped, with a closing note. Corsa picks the outcome in this order:- SAR - the alert’s Corsa case was closed as a SAR.
- Any true match - at least one match was decided as a true match.
- All cleared - otherwise.
Client Linking
Corsa links each ComplyAdvantage customer to a Corsa client. The first rule that applies wins:- Remembered link - a link set or confirmed earlier for the same ComplyAdvantage customer.
- Reference ID - the ComplyAdvantage
external_identifierequals the Corsa clientreferenceId. - Exact name - exactly one Corsa client has the same name. The alert shows Linked by name, confirm client.
- New client - when nothing matches, Corsa creates an individual client for a person or a corporate client for a company, tagged
complyadvantage-imported. - Manual link - otherwise the alert has no client and shows Manual client link required.
external_identifier. Corsa never changes an existing client.
For the best matching, set the ComplyAdvantage external_identifier to the stable customer ID you use as the Corsa client referenceId.
Fixing a client link
On a ComplyAdvantage alert, the client card shows:- Link client or Change client - search for and select the client the alert is about.
- Confirm and Reject - shown while the alert is Linked by name, confirm client. Reject removes the link, and Corsa doesn’t suggest that client for this customer again.
Prerequisites
- A ComplyAdvantage Mesh account. Legacy ComplyAdvantage API keys are not supported.
- A ComplyAdvantage Mesh API credential that can:
- view cases and alerts;
- decide risks, add notes, and transition cases;
- view case workflows (Supervisor or Admin role in ComplyAdvantage);
- view, create, and update webhooks.
- At least one decision stage in both your onboarding and monitoring workflows in ComplyAdvantage.
- Optional, for webhooks: your ComplyAdvantage webhook signing secret. You can’t create it yourself; contact ComplyAdvantage support to get it.
- Owner access to the Corsa application.
Setting Up the ComplyAdvantage Integration
Step 1: Connect
- Log in to Corsa.
- Go to Developers Hub → Integrations.
- Click Configure on the ComplyAdvantage card.
- Fill in the Connect screen:
- Save. Corsa checks the credential and the region, and loads your case workflows. The integration shows Pending Setup.
Step 2: Complete setup
On the Complete Setup screen, choose the ComplyAdvantage case stage Corsa moves a case to for each outcome. There are two groups, Onboarding cases and Monitoring cases, each with three outcomes:- All cleared
- Any true match
- SAR
If you change your workflows in ComplyAdvantage, open the integration and save again to refresh the stage lists.
Step 3: Turn on webhooks (optional)
The webhook signing secret isn’t available in the ComplyAdvantage app. Contact ComplyAdvantage support and ask for the webhook signing secret of your account.
Step 4: Check the integration
Open the Health section on the ComplyAdvantage integration card. It shows:- Connection and the last successful check.
- Webhooks: active, or polling only.
- Backfill: the progress of the first import.
- Updates to ComplyAdvantage that are waiting, on hold, or failed in the last 24 hours.
- The last error, if any.
Removing the Integration
When you remove the integration, Corsa turns off its webhooks in ComplyAdvantage, stops any running import, and cancels pending updates to ComplyAdvantage. Alerts already imported stay in Corsa. If you connect the same account again, Corsa doesn’t duplicate alerts or clients.Troubleshooting
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.