Saltar al contenido principal
POST
Preview repayment allocation

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

id
string<uuid>
requerido

Loan account identifier (UUID).

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

Cuerpo

application/json
amount
string
requerido

Repayment amount in major currency units (e.g. "125.00"). Must be positive with at most 2 fractional digits.

Ejemplo:

"125.00"

effectiveDate
string

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.

Ejemplo:

"2026-06-14T17:30:00Z"

transactionDate
string

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.

Ejemplo:

"2026-06-14T17:30:00Z"

Respuesta

OK

allocations
object[] | null
requerido

Per-installment allocation breakdown.

appliedAmount
string
requerido

Amount applied to the loan (2 d.p. string).

Ejemplo:

"125.00"

backdated
boolean
requerido

True if the repayment effective date is before the business date.

effectiveDate
string
requerido

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.

Ejemplo:

"2026-06-14T21:00:00Z"

loanAccountId
string
requerido

Loan account UUID.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

overpaymentAmount
string
requerido

Excess amount above total outstanding (2 d.p. string).

Ejemplo:

"0.00"