✦ ISLAMIC BANKING
CatalogRunFAQRepo ↗

Islamic Financing

Commodity Murabaha Tawarruq

isb-commodity-murabaha-tawarruq · isb-financing

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

View repository ↗The 48-domain landscape ↗

Business DomainSale Based Financing
Functional PatternProcess
Asset TypeTawarruq Transaction
Control RecordTawarruq Transaction Procedure

USEWhat it is used for

Representative use cases for the Commodity Murabaha Tawarruq service domain within a Shariah-compliant core-banking landscape.

APIBIAN semantic API

Each service domain exposes its control record (Tawarruq Transaction Procedure) 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/tawarruq-transaction-procedure/initiateInitiate
GET/v1/tawarruq-transaction-procedure/{crId}/retrieveRetrieve
PUT/v1/tawarruq-transaction-procedure/{crId}/updateUpdate
PUT/v1/tawarruq-transaction-procedure/{crId}/controlControl (suspend / resume / terminate)

INTBackend integrations

The systems and standards a real deployment of Commodity Murabaha Tawarruq 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-commodity-murabaha-tawarruq
mvn -f isb-commodity-murabaha-tawarruq spring-boot:run
curl localhost:8080/v1/service-domain

# or deploy onto Kubernetes (Cilium mesh)
helm upgrade --install isb-commodity-murabaha-tawarruq ./helm -n isb-financing

FAQQuestions

What is Murabaha?
Murabaha is a cost-plus sale. The bank buys an asset and sells it to the customer at cost plus a disclosed markup, with the total price fixed at contract. Installments never recompound like interest, and late payment goes to charity rather than to the bank.
What business area does Commodity Murabaha Tawarruq belong to?
Commodity Murabaha Tawarruq 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 Tawarruq Transaction asset, with the Tawarruq Transaction 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.

SEEIn the landscape

Commodity Murabaha Tawarruq is one of 48 Shariah-native service domains. Explore the whole platform:

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