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"
The moment the money moved, as a full RFC 3339 instant with a time and an offset. A bare YYYY-MM-DD calendar date is refused with LENDER-0348.
"2026-06-14T17:30:00Z"
The moment the money moved, as a full RFC 3339 instant, read when effectiveDate is absent. A bare YYYY-MM-DD calendar date is refused with LENDER-0348.
"2026-06-14T17:30:00Z"
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.
RFC 3339 instant the money moved, used for this preview. A bare calendar date is refused (LENDER-0103 is the charge equivalent; this route answers LENDER-0348): the day a payment belongs to is derived from the moment, so the moment is what the caller declares.
"2026-06-14T21:00:00Z"
Loan account UUID.
"550e8400-e29b-41d4-a716-446655440000"
Excess amount above total outstanding (2 d.p. string).
"0.00"

