Islamic Financing

Asset Acquisition Agency

isb-asset-acquisition-agency · isb-financing

A Shariah-native BIAN service domain in Islamic Financing. It applies the Process functional pattern to the Wakala Purchase Mandate, with the Wakala Purchase Mandate Procedure as its control record — one isolated Spring Boot microservice.

View repository ↗The 48-domain landscape ↗

Business DomainSale Based Financing

Functional PatternProcess

Asset TypeWakala Purchase Mandate

Control RecordWakala Purchase Mandate Procedure

USEWhat it is used for

Representative use cases for the Asset Acquisition Agency service domain within a Shariah-compliant core-banking landscape.

Originate Wakala Purchase Mandate deals: asset purchase → markup disclosure → deferred-sale to customer
Execute commodity legs with brokers and evidence constructive possession
Service installment schedules where the markup is fixed at contract (never recalculated as interest)
Route late-payment amounts to charity, not income (Shariah requirement)

APIBIAN semantic API

Each service domain exposes its control record (Wakala Purchase Mandate Procedure) 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-purchase-mandate-procedure/initiate`	Initiate
GET	`/v1/wakala-purchase-mandate-procedure/{crId}/retrieve`	Retrieve
PUT	`/v1/wakala-purchase-mandate-procedure/{crId}/update`	Update
PUT	`/v1/wakala-purchase-mandate-procedure/{crId}/control`	Control (suspend / resume / terminate)

INTBackend integrations

The systems and standards a real deployment of Asset Acquisition Agency would transact with.

Commodity platforms: Bursa Suq Al-Sila', DDCAP ETHOS (for Tawarruq)
Islamic LOS modules (iMAL, FLEXCUBE Islamic, Temenos)
Asset registries, valuers, and supplier networks (the bank actually buys the asset)

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-asset-acquisition-agency
mvn -f isb-asset-acquisition-agency spring-boot:run
curl localhost:8080/v1/service-domain

# or deploy onto Kubernetes (Cilium mesh)
helm upgrade --install isb-asset-acquisition-agency ./helm -n isb-financing

FAQQuestions

What business area does Asset Acquisition Agency belong to?

Asset Acquisition Agency sits in the Islamic Financing business area — asset-backed Islamic financing, where the bank trades in or co-owns real assets instead of lending money at interest. It follows the BIAN Process functional pattern over the Wakala Purchase Mandate asset, with the Wakala Purchase Mandate Procedure 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-financing 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.