Skip to main content
POST
Registrar reembolso

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Request-ID
string

Canonical idempotency request ID. Falls back to X-Idempotency when absent.

Ejemplo:

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

X-Idempotency
string

Fallback idempotency request ID used when X-Request-ID is absent.

Ejemplo:

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

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

ISO-8601 or YYYY-MM-DD effective date.

Ejemplo:

"2026-06-14"

transactionDate
string

ISO-8601 or YYYY-MM-DD transaction date (fallback when effectiveDate is absent).

Ejemplo:

"2026-06-14"

Respuesta

Created

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

ISO-8601 effective date applied to the repayment.

Ejemplo:

"2026-06-14"

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"

transactionId
string
requerido

Recorded repayment transaction UUID.

Ejemplo:

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

requestId
string

Idempotency request ID echoed from the request.

Ejemplo:

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