Operations and Execution
Customer Tax Withholding
sd-customer-tax-withholding · bian-operations
A BIAN service domain in Operations and Execution. It applies the Process functional pattern to the Tax Withholding Record, with the Tax Withholding Record Procedure as its control record — one independent Spring Boot microservice on the platform's Cilium eBPF mesh.
View repository ↗The 162-domain platform ↗
Business DomainAccount Management
Functional PatternProcess
Asset TypeTax Withholding Record
Control RecordTax Withholding Record Procedure
USEWhat it is used for
Representative use cases for the Customer Tax Withholding service domain within a BIAN-aligned core-banking landscape.
- Open, service, block, and close Tax Withholding Record records with full posting history
- Post deposits/withdrawals with balance and overdraft/minimum rules enforced
- Stream transaction events to fraud monitoring and customer notifications
- Drive interest accrual/fees and feed the general ledger
APIBIAN semantic API
The control record (Tax Withholding Record 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/tax-withholding-record-procedure/initiate | Initiate |
| GET | /v1/tax-withholding-record-procedure/{crId}/retrieve | Retrieve |
| PUT | /v1/tax-withholding-record-procedure/{crId}/update | Update |
| PUT | /v1/tax-withholding-record-procedure/{crId}/control | Control (suspend / resume / terminate) |
INTBackend integrations
The systems and standards a real deployment of Customer Tax Withholding would transact with.
- Core ledgers: Thought Machine Vault, Mambu, Temenos, Finacle
- Statements/comms: Quadient, OpenText Exstream
- Billing: Zuora, SAP BRIM
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-customer-tax-withholding
mvn -f sd-customer-tax-withholding spring-boot:run
curl localhost:8080/v1/service-domain
# or deploy onto Kubernetes (Cilium eBPF mesh)
helm upgrade --install sd-customer-tax-withholding ./helm -n bian-operations
FAQQuestions
What is the BIAN “Process” functional pattern?
A Process service domain executes and tracks a defined operational procedure, step by step, to completion. Customer Tax Withholding applies it to the Tax Withholding Record.
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. Customer Tax Withholding is the service domain for Account Management; it manages the Tax Withholding Record Procedure and exposes it through standard BIAN action terms.
What business area does Customer Tax Withholding belong to?
Customer Tax Withholding sits in the Operations and Execution business area — the operational core that executes payments, positions, settlements and transactions. It runs in the bian-operations namespace as one independent Spring Boot microservice.
Is Customer Tax Withholding 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
Customer Tax Withholding is one of 162 BIAN service domains on the platform. Explore the rest: