Deposits and Investment Accounts
Wakala Investment Account
isb-wakala-investment-account · isb-deposits
A Shariah-native BIAN service domain in Deposits and Investment Accounts. It applies the Fulfill functional pattern to the Wakala Investment Account, with the Wakala Investment Account Fulfillment Arrangement as its control record — one isolated Spring Boot microservice.
View repository ↗The 48-domain landscape ↗
USEWhat it is used for
Representative use cases for the Wakala Investment Account service domain within a Shariah-compliant core-banking landscape.
- Open and service Wakala Investment Account records under the correct contract (Wadiah/Qard/Mudarabah/Wakala)
- Gate activation on KYC + Shariah screening outcomes
- Attribute investment-account balances to profit-sharing pools (no interest accrual, ever)
- Stream postings to financial-crime monitoring
APIBIAN semantic API
Each service domain exposes its control record (Wakala Investment Account Fulfillment Arrangement) through uniform BIAN action terms. Java 21 · Spring Boot 3, with OpenAPI at /swagger-ui.html.
| Method | Path | BIAN action |
|---|
| GET | /v1/service-domain | Service metadata |
| POST | /v1/wakala-investment-account-fulfillment-arrangement/initiate | Initiate |
| GET | /v1/wakala-investment-account-fulfillment-arrangement/{crId}/retrieve | Retrieve |
| PUT | /v1/wakala-investment-account-fulfillment-arrangement/{crId}/update | Update |
| PUT | /v1/wakala-investment-account-fulfillment-arrangement/{crId}/control | Control (suspend / resume / terminate) |
INTBackend integrations
The systems and standards a real deployment of Wakala Investment Account would transact with.
- Islamic cores: Azentio iMAL, Oracle FLEXCUBE Islamic, Temenos Islamic Banking, ICS BANKS Islamic
- Profit-distribution engines; AAOIFI-aligned GL
- Channels: any conventional digital-banking front-end (the contract is the boundary)
RUNRun it yourself
Each domain is its own standalone Spring Boot repository — clone and run in seconds, or deploy onto Kubernetes with the bundled Helm chart.
# run this domain standalone
git clone https://github.com/Sreenivas-Sadhu-Prabhakara/isb-wakala-investment-account
mvn -f isb-wakala-investment-account spring-boot:run
curl localhost:8080/v1/service-domain
# or deploy onto Kubernetes (Cilium mesh)
helm upgrade --install isb-wakala-investment-account ./helm -n isb-deposits
FAQQuestions
What is Wakala?
Wakala is an agency contract: the customer appoints the bank as agent to invest or act on their behalf for a fee. Returns belong to the principal; the agent earns a disclosed fee rather than interest.
What business area does Wakala Investment Account belong to?
Wakala Investment Account sits in the Deposits and Investment Accounts business area — Shariah-compliant deposit and investment accounts, where returns come from profit-sharing and safekeeping rather than interest. It follows the BIAN Fulfill functional pattern over the Wakala Investment Account asset, with the Wakala Investment Account Fulfillment Arrangement as its control record.
How is this isolated from conventional banking?
Completely. The Islamic landscape shares no code, repositories, namespaces or events with the conventional platform. This domain lives in the isb-deposits namespace with an isb-* repository and com.bank.islamic package, so the two can never mix by accident.
Is this a certified Shariah-compliant product?
No. It is an educational reference implementation in the BIAN service-domain style. Actual Shariah compliance of any real deployment requires certification by a qualified Shariah Supervisory Board. Standards referenced: AAOIFI, IFSB, IIFM.
SEEIn the landscape
Wakala Investment Account is one of 48 Shariah-native service domains. Explore the whole platform: