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
- 401
- 403
- 404
- 409
- 422
- 500
- 503
The repayment was recorded.
Unauthorized
Forbidden
Contract not found; errorSource is : is CONTRACT_NOT_FOUND.
Contract is not in Active state, or the supplied externalId is already in use; errorSource is : is CONTRACT_NOT_ACTIVE or DUPLICATE_EXTERNAL_ID.
Request validation failed; errorSource is : is one of INVALID_AMOUNT (zero, negative, exceeds outstanding balance, wrong currency), INVALID_VALUE_DATE (future date, before activationDate, or older than 12 months), OVERPAYMENT_EXCEEDS_OUTSTANDING, DUPLICATE_EXTERNAL_ID or CONFIGURATION_INCOMPLETE (the contract's product configuration is incomplete; the detail names the missing feature). Missing required fields are reported without a code.
The repayment was rolled back and nothing was stored; errorSource is : is REPAYMENT_GL_POSTING_FAILED or REPAYMENT_PERSISTENCE_FAILED.
Lock-wait timeout acquiring the contract row; errorSource is : is REPAYMENT_LOCK_TIMEOUT. Retry after the interval in the Retry-After header.