Post a cash repayment on an active murabaha contract

POST 
/islamic-financing/murabaha/contracts/{id}/transactions/repayment

Accepts a cash payment, allocates it horizontally across outstanding instalments oldest-first, records an append-only RepaymentTransaction and BalanceChange ledger, and posts a single aggregate DR Cash / CR Murabaha Receivable GL entry. Idempotent via the Idempotency-Key header (TC-20).

Request

Responses

200

The repayment was recorded.

401

Unauthorized

403

Forbidden

404

Contract not found.

409

Contract is not in Active state, or the supplied externalId is already in use (DUPLICATE_EXTERNAL_ID).

422

Request validation failed — INVALID_AMOUNT (zero, negative, exceeds outstanding balance, wrong currency), INVALID_VALUE_DATE (future date, before activationDate, or older than 12 months), or missing required fields.

503

Lock-wait timeout acquiring the contract row (REPAYMENT_LOCK_TIMEOUT). Retry after the interval in the Retry-After header.