Preview repayment allocation
Returns a deterministic repayment allocation preview without recording a transaction. Not idempotency-gated. A malformed UUID yields 422 (schema error). A malformed amount string yields 422.
Authorizations
JWT bearer token issued by the identity provider.
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
OK
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 this preview.
"2026-06-14"
Loan account UUID.
"550e8400-e29b-41d4-a716-446655440000"
Excess amount above total outstanding (2 d.p. string).
"0.00"

