Prepagar la cuenta de préstamo

Anexa una versión inmutable del cronograma de prepago y un disparador de recálculo. Las cuentas de Brasil requieren quoteId; el prepago solo con amount está disponible únicamente para cuentas que no son de Brasil. Cuando se proporcionan ambos, amount debe coincidir con el importe neto de liquidación de la cotización. La idempotencia se aplica mediante el middleware de idempotencia de lib-commons a través del encabezado X-Idempotency; una clave reutilizada con datos diferentes produce 409. Una cotización de Brasil obligatoria ausente, un UUID mal formado o un importe no válido producen 422.

POST /api/v1/loan-accounts/{id}/prepayments

Prepagar la cuenta de préstamo

cURL

curl --request POST \
  --url https://lender.sandbox.lerian.net/api/v1/loan-accounts/{id}/prepayments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "businessDate": "<string>",
  "effectiveDate": "<string>",
  "transactionId": "<string>",
  "amount": "<string>",
  "quoteId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

201

{
  "previousScheduleVersionId": "<string>",
  "scheduleVersion": {
    "createdAt": "<string>",
    "id": "<string>",
    "installments": [
      {
        "dueDate": "<string>",
        "feesAmount": "<string>",
        "interestAmount": "<string>",
        "number": 123,
        "penaltiesAmount": "<string>",
        "principalAmount": "<string>",
        "principalRemaining": "<string>",
        "totalAmount": "<string>"
      }
    ],
    "loanAccountId": "<string>",
    "reason": "<string>",
    "triggerTransactionId": "<string>",
    "versionNumber": 123,
    "predecessorVersionId": "<string>"
  }
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency · string · requerido

Canonical idempotency request ID. Enforced by the lib-commons idempotency middleware.

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

businessDate · string · requerido

YYYY-MM-DD business date applied to the prepayment.

Ejemplo:

"2026-06-14"

effectiveDate · string · requerido

YYYY-MM-DD effective date of the prepayment.

Ejemplo:

"2026-06-14"

transactionId · string · requerido

Operator-supplied prepayment transaction identifier.

Maximum string length: 128

amount · string

Importe del prepago (cadena con 2 decimales). El prepago solo con amount está disponible únicamente para cuentas que no son de Brasil; las cuentas de Brasil requieren quoteId.

Ejemplo:

"100.00"

quoteId · string<uuid>

Settlement quote identifier. Required when amount is empty.

Ejemplo:

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

Respuesta

201

application/json

Created

previousScheduleVersionId · string · requerido

Predecessor schedule version UUID.

Ejemplo:

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

scheduleVersion · object · requerido

The newly appended immutable schedule version.

Show child attributes