✦ ISLAMIC BANKING
CatalogRunFAQRepo ↗

Shariah Governance and Compliance

Zakat Distribution

isb-zakat-distribution · isb-governance

A Shariah-native BIAN service domain in Shariah Governance and Compliance. It applies the Distribute functional pattern to the Zakat Disbursement, with the Zakat Disbursement Distribution as its control record — one isolated Spring Boot microservice.

View repository ↗The 48-domain landscape ↗

Business DomainShariah Governance
Functional PatternDistribute
Asset TypeZakat Disbursement
Control RecordZakat Disbursement Distribution

USEWhat it is used for

Representative use cases for the Zakat Distribution service domain within a Shariah-compliant core-banking landscape.

APIBIAN semantic API

Each service domain exposes its control record (Zakat Disbursement Distribution) 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/zakat-disbursement-distribution/initiateInitiate
GET/v1/zakat-disbursement-distribution/{crId}/retrieveRetrieve
PUT/v1/zakat-disbursement-distribution/{crId}/updateUpdate
PUT/v1/zakat-disbursement-distribution/{crId}/controlControl (suspend / resume / terminate)

INTBackend integrations

The systems and standards a real deployment of Zakat Distribution 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-zakat-distribution
mvn -f isb-zakat-distribution spring-boot:run
curl localhost:8080/v1/service-domain

# or deploy onto Kubernetes (Cilium mesh)
helm upgrade --install isb-zakat-distribution ./helm -n isb-governance

FAQQuestions

What is Zakat?
Zakat is an obligatory annual levy of 2.5% on zakatable wealth (cash, gold, investments) held for a lunar year, due when the wealth exceeds the nisab threshold (about 85g of gold). Islamic banks help compute, collect and distribute it.
What business area does Zakat Distribution belong to?
Zakat Distribution sits in the Shariah Governance and Compliance business area — the mandatory Shariah-governance layer that supervises, audits and evidences compliance across every Islamic banking line. It follows the BIAN Distribute functional pattern over the Zakat Disbursement asset, with the Zakat Disbursement Distribution 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-governance 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

Zakat Distribution is one of 48 Shariah-native service domains. Explore the whole platform:

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