✦ ISLAMIC BANKING
CatalogRunFAQRepo ↗

Takaful and Shared Operations

Retakaful Arrangement

isb-retakaful-arrangement · isb-operations

A Shariah-native BIAN service domain in Takaful and Shared Operations. It applies the Manage functional pattern to the Retakaful Treaty, with the Retakaful Treaty Management Plan as its control record — one isolated Spring Boot microservice.

View repository ↗The 48-domain landscape ↗

Business DomainTakaful
Functional PatternManage
Asset TypeRetakaful Treaty
Control RecordRetakaful Treaty Management Plan

USEWhat it is used for

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

APIBIAN semantic API

Each service domain exposes its control record (Retakaful Treaty Management Plan) 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/retakaful-treaty-management-plan/initiateInitiate
GET/v1/retakaful-treaty-management-plan/{crId}/retrieveRetrieve
PUT/v1/retakaful-treaty-management-plan/{crId}/updateUpdate
PUT/v1/retakaful-treaty-management-plan/{crId}/controlControl (suspend / resume / terminate)

INTBackend integrations

The systems and standards a real deployment of Retakaful Arrangement 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-retakaful-arrangement
mvn -f isb-retakaful-arrangement spring-boot:run
curl localhost:8080/v1/service-domain

# or deploy onto Kubernetes (Cilium mesh)
helm upgrade --install isb-retakaful-arrangement ./helm -n isb-operations

FAQQuestions

What is Retakaful?
Retakaful is the Takaful equivalent of reinsurance: Takaful operators share risk with a larger cooperative pool, on the same Shariah principles that avoid interest and excessive uncertainty.
What business area does Retakaful Arrangement belong to?
Retakaful Arrangement sits in the Takaful and Shared Operations business area — Takaful (cooperative insurance) and the shared operational domains that support the Islamic banking landscape. It follows the BIAN Manage functional pattern over the Retakaful Treaty asset, with the Retakaful Treaty Management Plan 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-operations 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

Retakaful Arrangement is one of 48 Shariah-native service domains. Explore the whole platform:

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