✦ ISLAMIC BANKING
CatalogRunFAQRepo ↗

Deposits and Investment Accounts

Wadiah Safekeeping Account

isb-wadiah-safekeeping-account · isb-deposits

A Shariah-native BIAN service domain in Deposits and Investment Accounts. It applies the Fulfill functional pattern to the Wadiah Custody Account, with the Wadiah Custody Account Fulfillment Arrangement as its control record — one isolated Spring Boot microservice.

View repository ↗The 48-domain landscape ↗

Business DomainIslamic Deposits
Functional PatternFulfill
Asset TypeWadiah Custody Account
Control RecordWadiah Custody Account Fulfillment Arrangement

USEWhat it is used for

Representative use cases for the Wadiah Safekeeping Account service domain within a Shariah-compliant core-banking landscape.

APIBIAN semantic API

Each service domain exposes its control record (Wadiah Custody Account Fulfillment Arrangement) through uniform BIAN action terms. Java 21 · Spring Boot 3, with OpenAPI at /swagger-ui.html.

MethodPathBIAN action
GET/v1/service-domainService metadata
POST/v1/wadiah-custody-account-fulfillment-arrangement/initiateInitiate
GET/v1/wadiah-custody-account-fulfillment-arrangement/{crId}/retrieveRetrieve
PUT/v1/wadiah-custody-account-fulfillment-arrangement/{crId}/updateUpdate
PUT/v1/wadiah-custody-account-fulfillment-arrangement/{crId}/controlControl (suspend / resume / terminate)

INTBackend integrations

The systems and standards a real deployment of Wadiah Safekeeping Account would transact with.

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-wadiah-safekeeping-account
mvn -f isb-wadiah-safekeeping-account spring-boot:run
curl localhost:8080/v1/service-domain

# or deploy onto Kubernetes (Cilium mesh)
helm upgrade --install isb-wadiah-safekeeping-account ./helm -n isb-deposits

FAQQuestions

What is Wadiah?
Wadiah is a safekeeping arrangement: the bank holds the customer’s deposit for safe custody and guarantees its return. Any reward is a voluntary gift (hibah), not contractual interest.
What business area does Wadiah Safekeeping Account belong to?
Wadiah Safekeeping 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 Wadiah Custody Account asset, with the Wadiah Custody 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

Wadiah Safekeeping Account is one of 48 Shariah-native service domains. Explore the whole platform:

✦ Platform overview The Master Catalog (48 domains) This repository ↗