sumsub-analyze-regulation

Analyze a regulation document (PDF or text) and produce a Sumsub configuration plan — mapping regulatory requirements to Sumsub entities (levels, questionnaires, PoA presets, TM rules, workflows, AML resolution rules). TRIGGER when the user provides a regulation PDF, legal act, or compliance require

By sumsub · 840 installs

npx skills add sumsub/agent-skills --skill sumsub-analyze-regulation

Source repository · Upstream listing

Sumsub — Analyze Regulation Reads a regulation document and produces a structured Sumsub configuration plan — mapping each regulatory requirement to the Sumsub entities that satisfy it, with a clear split between what can be configured now via skills and what requires the Sumsub Dashboard . This is a planning skill only . It produces a text description, never JSON payloads or API calls. Workflow Step 1 — Gather context Before analyzing, collect: Jurisdiction — if the document covers multiple countries or is ambiguous, ask explicitly: "This regulation covers [list of countries]. Which jurisdiction should the plan focus on?" Do not generate a plan for all jurisdictions simultaneously without a direct request to do so. Business type — crypto exchange, neobank, iGaming, fintech, or other. Ask if not clear from the document. Client types — individuals, companies, or both. Existing Sumsub setup — has the user already configured anything? Avoid suggesting duplicates. Step 2 — Analyze (think before responding) Use extended thinking before formulating the response. Extract from the document: Customer identification requirements (who must be identified, what data is required) Acceptable identity documents (national ID, passport, tax number, etc.) Address verification requirements (what documents are accepted, maximum age) Enhanced Due Diligence conditions (what triggers EDD) Source of funds / wealth / PEP data collection requirements AML screening obligations (PEP / sanctions / adverse media) and how screening hits must be handled (false positive clearing, PEP review policy, escalation of confirmed matches) Transaction monitoring requirements (thresholds, suspicious patterns, crypto Travel Rule) Periodic re KYC obligations (how often customers must be re verified) What is out of scope for Sumsub (data retention timelines, regulatory reporting, sanctions list maintenance) Step 3 — Validate understanding first After analysis, present a short "My Understanding" block — bullet points of extracted requirements — and ask: "Have I understood the key requirements correctly? Anything to add or correct?" Do not generate the full plan until the user confirms. This is mandatory. Step 4 — Generate the plan Only after user confirmation, produce the full configuration plan using the [output format]( output format) below. Sumsub Capability Map A. Verification Levels — sumsub create level Defines the sequence of verification steps an applicant must complete. Each step is a docSet . Available docSet types: Type Purpose IDENTITY Document verification: PASSPORT, ID CARD, DRIVERS, RESIDENCE PERMIT, VOTER ID, etc. Can be restricted by issuing country. SELFIE / SELFIE2 Biometrics and liveness. APPLICANT DATA Personal data collection: full name, date of birth, address, nationality, tax number (TIN/CPF/CNPJ/etc.). PROOF OF RESIDENCE / PROOF OF RESIDENCE2 Address document verification. References a PoA preset by poaStepSettingsId . PHONE VERIFICATION / EMAIL VERIFICATION Contact verification via OTP. QUESTIONNAIRE / QUESTIONNAIRE2–4 Custom form. References a questionnaire definition by questionnaireDefId . E KYC Non document electronic verification against external databases. See [E KYC section]( e kyc non document electronic verification). DEVICE CHECK Device intelligence and fingerprinting. Requires DEVICE INTELLIGENCE license. COMPANY KYB: company info collection. COMPANY DATA KYB: company data fields. COMPANY DOCUMENTS KYB: corporate documents upload. COMPANY BENEFICIARIES KYB: UBOs and representatives verification. ACCREDITED INVESTOR Accredited investor qualification. E SIGN Electronic signature capture. TR RECIPIENT INFORMATION Travel Rule recipient data collection. Level properties: applicantType : individual or company requiredIdDocs : the ordered list of docSets + optional includedCountries / excludedCountries disableWatchlists : set to true if tenant has WATCHLISTS entitlement but needs to disable AML Screening for a particular level crossCheckPresetId : cross check preset for AML screening IDENTITY — document type codes Sumsub uses generic IdDocType values regardless of what the document is locally called. Map the regulation's document names to these types: Generic document class Sumsub IdDocType International / biometric passport PASSPORT National identity card (any country) ID CARD Driver's licence DRIVERS Residence / immigration permit RESIDENCE PERMIT Voter ID VOTER ID Documents with no dedicated Sumsub type (e.g. tax cards, social security cards) OTHER DOCS includedCountries / excludedCountries use ISO 3166 alpha 3 (e.g. BRA , USA , DEU ). Two sided capture should be specified whenever a mandatory identifier (tax number, national number) appears on the back of the document. SELFIE — liveness options ( videoRequired ) Value Description Use when passiveLiveness Default. Advanced passive liveness, no movement required. Standard KYC — no stricter regulatory mandate. activeLiveness Active motion challenge (head movement detection). Regulation explicitly requires active/dynamic liveness. enabled Short video — applicant pronounces displayed digits. Regulation requires video identity check. photoRequired Photo only selfie, no liveness. Use only when explicitly requested; generally insufficient for AML compliance. staticLiveness Single frame analysis. Use only when explicitly requested. For most AML/KYC regulations without a specific liveness requirement, default to passiveLiveness . APPLICANT DATA — common field names Standard personal data fields: Field name Meaning firstName First / given name lastName Last / family name dob Date of birth country Country of residence (ISO 3166 alpha 3) town City / town street Street address postCode Postal / ZIP code nationality Nationality (ISO 3166 alpha 3) placeOfBirth Place of birth tin Tax identification number (TIN, CPF, SSN, BSN, etc.) When a regulation mandates collection of a national tax or identity number, map it to tin and mark it required: true . DEVICE CHECK — what it detects When DEVICE INTELLIGENCE license is active, this step flags: emulators, rooted/jailbroken devices, VPN/proxy/Tor connections, remote desktop software, and crypto mixer tools. Always note in the plan that this step silently falls back to disabled if the tenant lacks the entitlement — add a GET back verification step. B. Questionnaires — sumsub create questionnaire Custom forms for collecting applicant data not captured by document checks. Common use cases: source of funds, source of wealth, employment, PEP self declaration, trading experience, risk profile. Question types: text , textArea , date , dateTime , bool , select , selectDropdown , multiSelect , phone , countrySelect , countryMultiSelect , fileAttachment , multiFileAttachments . Conditional logic: sections and items can be shown/hidden based on previous answers. Risk scoring: each answer option can carry a score (0–100); scores sum automatically and can be referenced in downstream transaction monitoring rules. One questionnaire per level. Group distinct topics (source of funds, PEP self declaration, risk profile…) as separate sections within a single questionnaire — not as separate questionnaires. Default to one QUESTIONNAIRE step per level. A separate level legitimately gets its own questionnaire (e.g. an EDD level with an extended questionnaire) — that is still one per level, not an exception. Only plan multiple questionnaires on the same level if the user explicitly asks for it. C. Proof of Address Presets — sumsub create poa preset Reusable configuration for what documents are accepted as proof of address. Document categories: governmentOrganization — government issued (voter registration, tax bill, etc.) utilityProvider — utility bills bank — bank statements and letters mobileOperator — telecom bills other Key settings: maxMonths per category — maximum document age Cross validation: name/address comparison between identity document (POI) and address document (POA) — fuzzy or strict mode PoI as PoA: accept the identity document itself as proof of address Neobank blocklist: exclude documents from specific institutions (Revolut, N26, Wise, etc.) Country specific overrides: different rules per country D. E KYC (Non Document Electronic Verification) ⚠️ Requires separate activation per country through a Sumsub Customer Success Manager (CSM). License: E KYC TARGET . Configured via sumsub create level once activated. How it works: the applicant submits unique identifiers (TIN, document number, bank login) which are validated against external databases — no document photo required. Two configuration modes: 1. Standalone E KYC docSet — electronic verification only; applicant cannot upload documents instead 2. IDENTITY with ekycAllowed: true — applicant chooses: upload document photo OR complete E KYC Available database types: GOVERNMENT (national registries), CREDIT (credit bureaus), TELCO (telecom providers), BANKING , COMMERCIAL (business registries), CONSUMER , UTILITY , POSTAL , PROPRIETARY . Verification methods: ENRICHMENT , ONE X ONE MATCHING , TWO X TWO MATCHING , VALIDITY CHECK . Configuration rules: Country coverage depends entirely on client's license activations — there is no universal list Recommended to pair with a SELFIE step for biometric verification against database records Activation steps: (1) contact CSM to request per country activation, (2) run sumsub create level . E. Transaction Monitoring — sumsub create kyt rules ⚠️ Requires KYT license (and TRAVEL RULE for crypto, TM SCHEDULED EVENTS for periodic re KYC, KYT ANTI FRAUD for platform events). Describes what to configure at plan time in plain language. sumsub create kyt rules translates each rule into a conditionEl SumScript expression and POSTs it to the API. New rules always start in test mode ( dryRun: true ) — activating them requires the dashboard. Transaction types: finance — financial transactions (fiat and crypto) travelRule — crypto transactions subject to Travel Rule (FATF / VASP) kyc — KYC related events userPlatformEvent — login, signup, password reset, 2FA changes scheduledEvent — periodic triggers (requires TM SCHEDULED EVENTS license) Rule anatomy: Condition — trigger (e.g., "incoming crypto transaction $10,000") Action: score (add risk points), onHold (freeze transaction), awaitUser (request confirmation), reject (block) Risk score (0–100) — cumulative; multiple rules sum their scores Applicant change — move applicant to another level, trigger final rejection, or route to manual review Case creation — auto create a compliance investigation case on rule match Automated pre scoring enrichments (active for licensed tenants): AML watchlists (PEP, sanctions, adverse media) Crypto screening: Chainalysis, Elliptic, TRM Labs, Merkle Science, Crystal Travel Rule processing Device intelligence and fingerprinting BIN lookup and payment method analytics Periodic Re KYC (Scheduled Rules): Trigger: applicants on level X for N days → reassign to a new level (triggers re verification) Requires TM SCHEDULED EVENTS license Required licenses for TM features: KYT , TRAVEL RULE , TM SCHEDULED EVENTS , KYT ANTI FRAUD , DEVICE INTELLIGENCE . F. Workflows — sumsub create workflow Graph based r