KYC Platform Overview
The KYC platform onboards your customers - natural persons and corporates - and keeps them compliant over their lifetime. It collects the required data through questionnaires and documents, performs compliance screening (PEP, sanctions, criminal, adverse media), risk assessment, and ongoing due diligence, and reports progress to your application through webhooks.
Integration follows one pattern everywhere:
- Create the entity - a Person for retail customers, or a Corporate with its linked Individuals.
- Trigger an Entitlement - a capability workflow such as onboarding, derivatives access, or a deposit-limit upgrade.
- Fulfil the requirements delivered via
requirementsQuestionnairewebhooks (questionnaires and document uploads). - Receive the outcome via the completion webhooks (
entitlementCompleted/entitlementFailed).
Onboarding Flows at a Glance
Which onboarding flow applies to your integration is fixed by your entitlement configuration, agreed during integration setup - it is not selected per request.
| Standard KYC | Reliance KYC | KYB (Corporate) | |
|---|---|---|---|
| Onboards | Person | Person | Corporate + linked Individuals |
| Entity setup | POST /persons | POST /persons | POST /corporates, POST /individuals, role links |
| Identity verification | By the platform (Fourthline IDV) | By you - results submitted via the Identity Verification questionnaire | By you - results submitted via questionnaires for the Business Contact and Individuals |
| IDV webhooks / Fourthline SDK | Yes | No | No |
| Questionnaires | Retail onboarding (+ country-specific) | Retail onboarding + Identity Verification (+ country-specific) | Corporate onboarding (+ obligated party, + country-specific), Corporate identity Verification, Corporate ID document verification |
| Screening (PEP, sanctions, criminal, adverse media) | Platform | Platform | Platform - corporate and every linked Individual |
| Risk assessment & EDD | Platform | Platform | Platform |
| Completion | entitlementCompleted / entitlementFailed | entitlementCompleted / entitlementFailed | entitlementCompleted / entitlementFailed |
A standard KYB variant - platform-performed IDV of the Business Contact - is in development; today, all corporate onboarding uses the reliance flow.
After onboarding, further entitlements cover derivatives access, deposit-limit upgrades (PoSoF), and the DLT-initiated review processes (Ad Hoc EDD, RFI).
Glossary
| Term | Meaning |
|---|---|
| Person | A natural person onboarded as a retail customer (owner_type: person). |
| Corporate | A legal entity onboarded via KYB (owner_type: corporate). |
| Individual | A natural person attached to a Corporate - representative, UBO, or Business Contact (owner_type: individual). Not a Person entity. |
| Business Contact | The Individual acting as the corporate's operational contact (also called the Acting Person). Exactly one per corporate; answers the Corporate identity Verification questionnaire. |
| UBO | Ultimate Beneficial Owner - an Individual linked with the shareholder/beneficiary role (or fictitious_ubo where no real UBO exists). |
| Entitlement | A triggerable capability workflow (onboarding, derivatives, PoSoF, ...). See Entitlements. |
| KYC / KYB | Know Your Customer (Persons) / Know Your Business (Corporates) onboarding. |
| IDV | Identity Verification - the platform-performed remote identification step (Fourthline), used only in the standard KYC flow. |
| Reliance | A flow in which the platform relies on the identity verification you have already performed; you submit its results via questionnaires. The platform still screens and risk-assesses. |
| EDD | Enhanced Due Diligence - additional information requests when a risk assessment requires it. |
| PoSoF | Proof of Source of Funds - deposit-limit tiers. See PoSoF. |
| RFI | Request For Information - a DLT-initiated information request. See RFI. |
"Retail" generally refers to Person accounts (retail customers), as opposed to Corporates. The Derivatives pages additionally use retail client in its MiFID classification sense (e.g., the Qualified Retail entitlement) - there, it describes the investor category, not the owner type.
Where to Go Next
- Authentication - obtaining and using API tokens.
- Person / Corporate & Individuals - creating the entities.
- Questionnaire Mechanism - how questionnaires, documents, and responses work.
- Entitlements - triggering workflows and tracking their status.
- Onboarding flows - KYC (standard & reliance) and KYB in detail.
- Webhooks - payloads, events reference, error codes, and signature verification.