Diminishing Musharakah Rail

Declining partnership contract endpoints for Islamic home and asset financing.

Overview

The Diminishing Musharakah rail provides:

Declining equity partnership contract creation and management
Gradual ownership transfer (buyout) scheduling
Rental payment calculation on the institution’s remaining share
Combined rental and buyout payment processing

Diminishing Musharakah (Musharakah Mutanaqisah) is a partnership contract where one partner (typically the customer) gradually purchases the other partner’s (typically the institution’s) share over time, eventually becoming the sole owner of the asset. It combines elements of Musharakah (partnership), Ijarah (lease), and Bay (sale) in a structured arrangement.

This contract is the most widely used Islamic alternative to conventional mortgages and asset financing. The institution and customer jointly acquire an asset, the customer pays rent on the institution’s share, and simultaneously makes periodic purchases of the institution’s equity units until full ownership transfers to the customer.

The rental amount declines over time as the institution’s share decreases, making it distinct from conventional fixed-rate mortgages. The buyout promise and the lease are separate undertakings that must not be made conditional upon each other under Shariah principles.

Endpoints

Create Diminishing Musharakah Contract

POST /v1/rails/diminishing-musharakah/contracts

const contract = await iof.diminishingMusharakah.create({
  asset_description: "Residential property - 42 Elm Street, Unit 7A",
  asset_value: 600000,
  currency: "USD",
  institution_contribution: 480000,
  customer_contribution: 120000,
  customer_id: "cpty_homebuyer",
  rental_rate: 0.04,
  buyout_schedule: {
    frequency: "monthly",
    duration_months: 240,
    buyout_amount_per_period: 2000,
  },
});

Response:

{
  "id": "dms_xyz",
  "type": "diminishing_musharakah",
  "status": "DRAFT",
  "asset_value": 600000,
  "currency": "USD",
  "institution_share": 0.8,
  "customer_share": 0.2,
  "current_rental": 1600,
  "buyout_schedule": {
    "frequency": "monthly",
    "duration_months": 240,
    "buyout_amount_per_period": 2000,
    "total_monthly_payment": 3600
  },
  "created_at": "2024-01-15T10:30:00Z"
}

Get Diminishing Musharakah Contract

GET /v1/rails/diminishing-musharakah/contracts/:id

List Diminishing Musharakah Contracts

GET /v1/rails/diminishing-musharakah/contracts

Execute Diminishing Musharakah Contract

POST /v1/rails/diminishing-musharakah/contracts/:id/execute

Process Buyout Payment

POST /v1/rails/diminishing-musharakah/contracts/:id/buyout

Early Full Buyout

POST /v1/rails/diminishing-musharakah/contracts/:id/full-buyout

Get Ownership Schedule

GET /v1/rails/diminishing-musharakah/contracts/:id/ownership-schedule

Payment Structure

Component	Description
`rental`	Rent paid on the institution’s remaining share
`buyout`	Purchase of equity units from the institution
`total_payment`	Combined rental and buyout amount

The rental portion decreases over time as the institution’s share declines, while the buyout portion remains constant or increases to accelerate ownership transfer.

Contract Status

Status	Description
`DRAFT`	Contract created, pending review
`PENDING_SHARIAH_REVIEW`	Awaiting Shariah board approval
`SHARIAH_APPROVED`	Approved by Shariah board
`ACTIVE`	Partnership active, payments ongoing
`NEAR_COMPLETION`	Customer share exceeds 90%
`COMPLETED`	Full ownership transferred
`TERMINATED`	Partnership dissolved early

Shariah Compliance

Both partners must share in the risk of asset ownership proportional to their shares
The rental rate must be based on the institution’s share and a fair market rental
The buyout promise and the lease agreement are separate, independent undertakings
The rental must decrease as the institution’s share decreases
The institution bears maintenance and insurance costs proportional to its share
The customer may accelerate buyout payments without penalty
Asset revaluation for buyout pricing must follow fair market principles

Webhooks

Event	Description
`diminishing_musharakah.contract.created`	Contract created
`diminishing_musharakah.contract.executed`	Partnership commenced
`diminishing_musharakah.payment.received`	Monthly payment processed
`diminishing_musharakah.buyout.processed`	Equity unit transferred
`diminishing_musharakah.contract.completed`	Full ownership transferred

Standards

Next Steps

Musharakah Rail - Full equity partnership
Ijarah Rail - Islamic leasing
Murabaha Rail - Cost-plus financing
Contracts Rail - General contract management