Prepagar la cuenta de préstamo (alias BR)

Ruta con alias BR para prepagar una cuenta de préstamo. Se resuelve al mismo handler que el endpoint central, con el resolvedor de jurisdicción insertado en la cadena. Las cuentas de Brasil requieren quoteId; cuando también se proporciona 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 ausente, un UUID mal formado o un importe no válido producen 422.

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

Prepagar la cuenta de préstamo (alias BR)

cURL

curl --request POST \
  --url https://lender.sandbox.lerian.net/api/v1/br/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