Disburse loan application
Validates disbursement eligibility, dispatches the resolving jurisdictional disbursement pipeline inside the parent transaction, and moves an approved application to disbursed. Idempotent: the lib-commons middleware enforces replay detection via X-Idempotency.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Canonical idempotency request ID (lib-commons enforcer reads this).
Path Parameters
Loan application identifier.
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
Body
Disbursement timestamp (RFC3339).
"2026-06-14T12:00:00Z"
Gross requested disbursement amount as a decimal string (e.g. "50000.00").
"50000.00"
Loan account identifier (UUID).
"7c9e6679-7425-40de-944b-e07fc1f90ae7"
Net delivered disbursement amount as a decimal string (e.g. "49500.00").
"49500.00"
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.
3^[A-Z]{3}$"BRL"
Opaque per-jurisdiction disbursement payload, validated at the use-case layer.
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".
"250.00"
Response
OK
Authenticated officer who created the application (request subject).
Borrower identifier.
Expected disbursement date (RFC3339, UTC).
"2026-06-14T12:00:00Z"
Loan application identifier (UUID).
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
Loan product version this application was created against (UUID).
"550e8400-e29b-41d4-a716-446655440000"
ISO-2 jurisdiction code resolved at preview time.
"BR"
Jurisdiction profile version resolved at preview time.
"1.0.0"
Preview schedule snapshot this application was created from (UUID).
"6ba7b810-9dad-11d1-80b4-00c04fd430c8"
Number of installments requested.
24
Requested monthly interest rate as a decimal string, scale 8 (e.g. "0.00000100").
"0.00000100"
Requested principal amount as a decimal string, minor-unit precision scale 2 (e.g. "50000.00").
"50000.00"
Lifecycle status: one of pending_approval, approved, rejected, withdrawn, disbursed.
"pending_approval"
Approval facts; present only when the application is approved or disbursed.
Disbursement facts; present only when the application is disbursed.
Rejection facts; present only when the application is rejected.
Withdrawal facts; present only when the application is withdrawn.

