Record repayment
Records a repayment allocation for an active loan account. Idempotency is enforced in the use case via the X-Request-ID header (X-Idempotency fallback): a reused request ID with different facts yields 409. A malformed UUID or amount yields 422.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Canonical idempotency request ID. Falls back to X-Idempotency when absent.
"550e8400-e29b-41d4-a716-446655440010"
Fallback idempotency request ID used when X-Request-ID is absent.
"550e8400-e29b-41d4-a716-446655440011"
Path Parameters
Loan account identifier (UUID).
"550e8400-e29b-41d4-a716-446655440000"
Body
Repayment amount in major currency units (e.g. "125.00"). Must be positive with at most 2 fractional digits.
"125.00"
ISO-8601 or YYYY-MM-DD effective date.
"2026-06-14"
ISO-8601 or YYYY-MM-DD transaction date (fallback when effectiveDate is absent).
"2026-06-14"
Response
Created
Per-installment allocation breakdown.
Amount applied to the loan (2 d.p. string).
"125.00"
True if the repayment effective date is before the business date.
ISO-8601 effective date applied to the repayment.
"2026-06-14"
Loan account UUID.
"550e8400-e29b-41d4-a716-446655440000"
Excess amount above total outstanding (2 d.p. string).
"0.00"
Recorded repayment transaction UUID.
"550e8400-e29b-41d4-a716-446655440001"
Idempotency request ID echoed from the request.
"550e8400-e29b-41d4-a716-446655440010"

