Risk and Compliance
Know Your Customer
sd-know-your-customer · bian-risk-compliance
A BIAN service domain in Risk and Compliance. It applies the Process functional pattern to the KYC Assessment, with the KYC Assessment Procedure as its control record — one independent Spring Boot microservice on the platform's Cilium eBPF mesh.
View repository ↗The 162-domain platform ↗
Business DomainFinancial Crime
Functional PatternProcess
Asset TypeKYC Assessment
Control RecordKYC Assessment Procedure
USEWhat it is used for
Representative use cases for the Know Your Customer service domain within a BIAN-aligned core-banking landscape.
- Detect suspicious KYC Assessment patterns in real time and raise scored alerts
- Run KYC/CDD checks at onboarding and on trigger events
- Manage investigations end-to-end with audit-grade decision trails
- File STRs/SARs to the FIU with supporting evidence
APIBIAN semantic API
The control record (KYC Assessment Procedure) is exposed through uniform BIAN action terms. Java 21 · Spring Boot 3, OpenAPI at /swagger-ui.html, health at /actuator/health.
| Method | Path | BIAN action |
|---|
| GET | /v1/service-domain | Service metadata |
| POST | /v1/kyc-assessment-procedure/initiate | Initiate |
| GET | /v1/kyc-assessment-procedure/{crId}/retrieve | Retrieve |
| PUT | /v1/kyc-assessment-procedure/{crId}/update | Update |
| PUT | /v1/kyc-assessment-procedure/{crId}/control | Control (suspend / resume / terminate) |
INTBackend integrations
The systems and standards a real deployment of Know Your Customer would transact with.
- AML & monitoring: NICE Actimize, SAS AML, Oracle FCCM
- Screening: Refinitiv World-Check, Dow Jones; device intel: BioCatch
- Case management platforms
RUNRun it yourself
Each service domain is its own standalone Spring Boot repository — clone and run in seconds, or deploy onto Kubernetes with the bundled Helm chart behind the Cilium mesh.
# run this service domain standalone
git clone https://github.com/Sreenivas-Sadhu-Prabhakara/sd-know-your-customer
mvn -f sd-know-your-customer spring-boot:run
curl localhost:8080/v1/service-domain
# or deploy onto Kubernetes (Cilium eBPF mesh)
helm upgrade --install sd-know-your-customer ./helm -n bian-risk-compliance
FAQQuestions
What is the BIAN “Process” functional pattern?
A Process service domain executes and tracks a defined operational procedure, step by step, to completion. Know Your Customer applies it to the KYC Assessment.
What is a BIAN service domain?
BIAN (the Banking Industry Architecture Network) decomposes a bank into independent service domains, each owning exactly one business capability. Know Your Customer is the service domain for Financial Crime; it manages the KYC Assessment Procedure and exposes it through standard BIAN action terms.
What business area does Know Your Customer belong to?
Know Your Customer sits in the Risk and Compliance business area — the risk, financial-crime and regulatory-compliance domains that keep the bank safe and compliant. It runs in the bian-risk-compliance namespace as one independent Spring Boot microservice.
Is Know Your Customer production-ready?
It is an educational reference implementation: a real BIAN REST API over an in-memory store, ready to be filled with domain logic. It is not a live bank and is not affiliated with BIAN.
SEEIn the landscape
Know Your Customer is one of 162 BIAN service domains on the platform. Explore the rest: