Skip to main content
Origination is the journey from “a borrower wants credit” to “a loan account exists and funds are out.” Lender models it as an explicit application lifecycle so every decision is recorded and every disbursement is traceable.

​
The application lifecycle

An application moves through named states. Each transition is a distinct operation, and each keeps a decision or disbursement record: 
                approve ─────────► disburse
              ╱                              ╲
submit ──────┤                                └─► loan account
              ╲ reject
               ╲ withdraw

​
Steps

1

Preview the schedule (optional)

POST /api/v1/loan-applications/preview-schedule computes the amortisation schedule for prospective terms without originating anything. Use it to show installments and disclosures before anyone commits.
2

Submit the application

POST /api/v1/loan-applications creates the application against an active product version. Writes are idempotent — send an idempotency key and a retried submit collapses to the same application.
3

Decide

Resolve the application with exactly one of:
  • POST /api/v1/loan-applications/{id}/approve — accept it; a decision record is kept.
  • POST /api/v1/loan-applications/{id}/reject — decline it, with a decision record.
  • POST /api/v1/loan-applications/{id}/withdraw — retract it before it is decided.
4

Disburse

POST /api/v1/loan-applications/{id}/disburse releases funds. Lender records the disbursement facts, books the disbursement to the ledger through the product’s accounting profile, and the loan becomes an active loan account you service from here on.

​
What you get

Disbursement produces a loan account — the servicing view of the live contract, carrying its schedule, transactions, charges, and audit history. Continue in Service a loan.

​
What happens downstream

The lifecycle emits loan_application.submitted, loan_application.approved, loan_application.rejected, loan_application.withdrawn, and loan_application.disbursed. The disbursement also drives a ledger posting via the posting path.
Brazilian origination adds regulated steps — CET disclosure and capitalization consent — covered in the Brazil regulatory pack. The payroll-deducted consignado flow originates in a single call; see Consignado privado.

​
Next steps

Service a loan

Record repayments, prepay, reschedule, and correct an active loan account.