Skip to main content
POST
Desembolsar la solicitud de préstamo

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency
string
requerido

Canonical idempotency request ID (lib-commons enforcer reads this).

Parámetros de ruta

id
string<uuid>
requerido

Loan application identifier.

Ejemplo:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Cuerpo

application/json
disbursedAt
string
requerido

Disbursement timestamp (RFC3339).

Ejemplo:

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

grossRequestedAmount
string
requerido

Gross requested disbursement amount as a decimal string (e.g. "50000.00").

Ejemplo:

"50000.00"

loanAccountId
string
requerido

Loan account identifier (UUID).

Ejemplo:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

netDeliveredAmount
string
requerido

Net delivered disbursement amount as a decimal string (e.g. "49500.00").

Ejemplo:

"49500.00"

currency
string

Optional ISO-4217 currency assertion (3 uppercase letters). When present it MUST equal the loan application's currency (a double-entry guard); a divergence is rejected with 422. When omitted, the loan's own currency is used.

Required string length: 3
Pattern: ^[A-Z]{3}$
Ejemplo:

"BRL"

jurisdictionExtensions
object

Opaque per-jurisdiction disbursement payload, validated at the use-case layer.

originationFeeAmount
string

Optional per-disbursement IF origination fee as a decimal string, net-of-IOF (e.g. "250.00"). Cost metadata persisted for accrual (AC0 = principal - fee); NOT a withholding and does not affect the Net = Gross - withholdings balance. Omitted or empty defaults to "0".

Ejemplo:

"250.00"

Respuesta

OK

assignedOfficerId
string
requerido

Authenticated officer who created the application (request subject).

borrowerId
string
requerido

Borrower identifier.

expectedDisbursementDate
string
requerido

Expected disbursement date (RFC3339, UTC).

Ejemplo:

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

id
string
requerido

Loan application identifier (UUID).

Ejemplo:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

loanProductVersionId
string
requerido

Loan product version this application was created against (UUID).

Ejemplo:

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

previewJurisdictionCode
string
requerido

ISO-2 jurisdiction code resolved at preview time.

Ejemplo:

"BR"

previewProfileVersion
string
requerido

Jurisdiction profile version resolved at preview time.

Ejemplo:

"1.0.0"

previewScheduleSnapshotId
string
requerido

Preview schedule snapshot this application was created from (UUID).

Ejemplo:

"6ba7b810-9dad-11d1-80b4-00c04fd430c8"

requestedInstallments
integer<int64>
requerido

Number of installments requested.

Ejemplo:

24

requestedInterestRate
string
requerido

Requested monthly interest rate as a decimal string, scale 8 (e.g. "0.00000100").

Ejemplo:

"0.00000100"

requestedPrincipalAmount
string
requerido

Requested principal amount as a decimal string, minor-unit precision scale 2 (e.g. "50000.00").

Ejemplo:

"50000.00"

status
string
requerido

Lifecycle status: one of pending_approval, approved, rejected, withdrawn, disbursed.

Ejemplo:

"pending_approval"

approvalDecision
object

Approval facts; present only when the application is approved or disbursed.

disbursementEvent
object

Disbursement facts; present only when the application is disbursed.

rejectionDecision
object

Rejection facts; present only when the application is rejected.

withdrawalDecision
object

Withdrawal facts; present only when the application is withdrawn.