> ## Documentation Index > Fetch the complete documentation index at: https://docs.compuzign.com/llms.txt > Use this file to discover all available pages before exploring further. # How to create and submit a loan application > Step-by-step guide to creating a loan application draft, filling in all required sections, and submitting it for adjudication. Creating a loan application is a multi-section process. You fill in the sections on the application page, and each section has its own Save button. Submit and Abandon sit at the bottom of the page once the required sections are captured. Once submitted, the application is placed in the Adjudication queue. ## Before you start Make sure the following conditions are met before opening a new application. * **The member is ACTIVE.** You cannot draft a loan for a suspended, inactive, or deceased member. Reactivate the member first. * **The member's KYC status allows it.** You can draft an application for any member except one whose KYC is UNVERIFIED or FAILED, so a member who is still in progress or in manual review can be drafted. To submit, though, the member's KYC must be exactly VERIFIED. A drafted application for an in-progress or manual-review member is blocked at submission until verification completes. * **You have the Credit Officer role.** You need permission to create and submit loan applications. Contact your Administrator if you are unsure about your role. ## Steps to create and submit an application From the main navigation, select **Loans**, then click **New application** in the top-right corner of the loans list. Type the member's name or member account number into the member search field. Select the correct member from the results. The member's basic details pre-fill the Applicant Information section. Encrypted identifiers like the TRN are not part of this loan member search. Choose the loan type. The dropdown lists the loan types your credit union has defined, and the visible names are configurable by your credit union. Each one maps to one of four fixed archetypes that drive the behaviour: **Unsecured**, **Cash secured**, **Motor vehicle** (AUTO), or **Real estate** (MORTGAGE). The loan type determines which form sections appear. See [Loan Types](/loans/loan-types) for a full breakdown. The loan type is locked once the application is submitted. If you select the wrong type, you must abandon the draft and start a new application. Choose the loan product that applies to this application. Products are configured by your credit union and determine the eligible amount range, term limits, and applicable rate tables. Confirm or complete the applicant's personal details: name, date of birth, contact information, and address. The member record is the source of truth, so you confirm rather than re-enter, and encrypted identifiers such as TRN, driver's licence, and passport are never re-typed in plaintext here. Enter the applicant's employment details: employment type (employed, self-employed, or pensioner), employment status (permanent, contract, or temporary), employer name, position held, length of employment, and gross monthly income. Employment type and employment status are scored as separate risk factors, so capture both. The platform uses this information to calculate risk and residual income. Capture the applicant's income and monthly expenses. **Income sources.** At least one is required; submission is rejected without one. Each income line carries an applicability percentage, so income that counts only partially toward affordability (a bonus counted at 50%, for example) is weighted accordingly. **Monthly expenses.** List every outgoing under a category. The category dropdown covers Statutory Deductions, Pension, Existing Loan Payment, Other Payment, Property-Related, Utility / Household, Personal / Family, Transportation, and Other Expense. **Quick add** chips drop the common ones in with one click: Utility / Household, Transportation, Personal / Family, Existing Loan Payment, and Property-Related. Utility bills go under Utility / Household. As you type, the section shows a live **Total income**, **Total expenses**, **Net monthly** (which turns red if it goes negative), and a **TDSR** percentage with a colour-coded band chip. Click **Save statement of affairs**. The platform uses these figures for the Total Debt Service Ratio (TDSR) and residual income. Enter the loan amount requested and the requested term in months. The amount and term must fall within the product's configured limits, which the platform enforces. A mortgage product can run up to 480 months; most products cap lower. Describe the purpose in free text and tag it with a purpose category, which the adjudication queue uses for filtering. Pick the preferred repayment method (standing order, payroll deduction, or direct debit); standing order is the default. Depending on the loan type you selected, an additional section appears. * **Cash-Secured:** Pledge one to five accounts as security. You can mix types, for example shares plus a fixed deposit. Each account has a type (Cash / Shares, Fixed / Time Deposit, or Savings Hypothecation), its account number, and the amount held. The card shows the combined total and the most you can borrow against it. The requested loan cannot exceed 95% of the combined pledged cash; the platform warns you and blocks submit if it does. * **Auto:** Enter the vehicle's make, model, year, VIN, engine number, and estimated valuation, plus optional mileage. Insurance is confirmed during the Securities review, not captured here. * **Mortgage:** Enter the property type, address, estimated valuation, valuation date, security type (First Mortgage, Second Mortgage, Strata Title, or Other), and any registered mortgagees. Title and insurance are Securities-review concerns, not application fields. This section does not appear for Unsecured loans. If the application requires or benefits from a guarantor, click **Add Guarantor** and fill in the guarantor's personal, employment, and income details, along with their relationship to the applicant, which is required. You can add more than one guarantor. Each guarantor has its own **Documents** block. Use the **ID**, **Income**, and **Employment** buttons to upload that guarantor's identification, proof of income, and employment letter. You can view a file or remove it later. The documents follow the loan, so the Adjudicator, Securities, and Disbursement reviewers see them downstream. Each upload runs the same checks as any member document: a 10 MB size cap, magic-byte type check, and virus scan. You can add or remove guarantors, and upload or remove their documents, at any time while you are editing the application. The application carries creditor-life cover by default. The **Creditor-life insurance** section lets you tune it for this loan. * **This loan carries creditor-life cover** is the on/off toggle, on by default. Untick it for a loan with no cover. * **Premium basis** is **Level (full sum, whole term)** or **Declining balance (reduces as repaid)**. Level is the default. * **Sum insured** defaults to the requested principal. Set a different figure when the cover differs from the loan amount. * **Manual total premium (optional)** lets you enter the whole-term premium directly. Leave it blank to use the actuarial table. The section shows the **Estimated premium** three ways that reconcile: per month, per year, and the total over the loan term. The monthly figure leads, because it is the one added to the total monthly payment and counted in the affordability (TDSR) check. The figures recompute when you save. Click **Save insurance**. Insurance is editable only while the application is a DRAFT. The **Fees that will apply** card lists the standard fees for this loan: each fee with its **Amount**, its **GCT**, and its **Treatment** (deducted from proceeds, paid separately, or added to the loan), then the **Total fees + GCT** and the **Net to member** after deductions. It is estimated on the requested amount and is read-only here. The Disbursement officer finalises fees at funding. See [Fees, deductions, and GCT](/disbursement/fees-and-gct). Before submitting, review the figures the platform calculates automatically on the application page. * **Risk Band** (R1 to R5): the band mapped from the sum of seven categorical factors (employment type, employment status, length of employment, TDSR, LTV, loan type, and credit history). * **TDSR**: share of gross income going to all debt repayments. * **LTV**: loan amount as a proportion of collateral value (secured loans only). * **Monthly payment**: estimated repayment amount. * **Mandatory shares**: the member equity required to hold the loan, shown as its own tile. The greater of JMD \$2,000 or 15% of the loan amount. * **Residual income**: take-home income remaining after all obligations. * **Total monthly payment**: the loan repayment plus compulsory savings plus the creditor life premium. These are estimates displayed during capture. The authoritative figures are confirmed at Adjudication. When you are satisfied that all sections are complete and the figures look correct, click **Submit**. The application status moves from DRAFT to SUBMITTED, and it is automatically placed in the Adjudication queue. If the member's KYC status is not exactly VERIFIED, submission is blocked. The platform stops the submission server-side rather than just hiding a button, so it holds even against a stale page. Complete KYC verification before attempting to submit. Your loan is assigned a unique Loan ID (for example, MDVL-UNS-00001) when the draft is created, which is the moment you pick the member, loan type, and product. This ID appears in the application header and in all subsequent notifications. *** ## Saving a draft You do not need to complete all sections in a single session. Each section has its own save action, with labels like **Save loan parameters**, **Save statement of affairs**, **Save net worth**, **Save cash details**, **Save vehicle details**, and **Save insurance**. Save the section you are working on to preserve its contents. The application stays in DRAFT status, and you can return to it from the Loans list at any time. Saving is explicit: your progress is preserved when you save a section, so save before navigating away. *** ## Abandoning a draft If you started an application but decide not to proceed, use the **Abandon Draft** option from the application's action menu. The UI confirms with an "Abandon this draft?" dialog before flipping the status. Abandoning runs through the workflow engine and is gated by the `loans.edit` capability. The status changes to **DRAFT\_ABANDONED**, the record is preserved in the audit trail, and the application is removed from your active drafts. An abandoned draft cannot be reopened or resubmitted. If you need to proceed with the same member, create a new application. *** ## Auto-calculated fields The platform calculates these figures and shows them as you capture the application. | Field | How it's calculated | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Risk Band (R1 to R5)** | The band mapped from the sum of seven categorical factors: employment type, employment status, length of employment, TDSR, LTV, loan type, and credit history. R1 is the lowest risk; R5 is the highest. | | **TDSR** | Total monthly debt payments divided by total applicable income. Includes the proposed new loan repayment. | | **LTV** | Requested loan amount divided by collateral value. Applies to Cash-Secured, Auto, and Mortgage loans only. | | **Monthly payment** | Calculated using the applicable rate from the loan product's rate table and the requested term. | | **Residual income** | Gross monthly income minus all monthly obligations (existing debts plus new loan payment plus living expenses). | | **Mandatory shares** | The required member-equity share purchase: the greater of JMD \$2,000 or 15% of the loan amount. | | **Compulsory savings** | A savings contribution added to the monthly payment: the greater of JMD \$2,000 or 5% of the monthly loan amortization payment. | | **Creditor life premium** | An insurance premium. Drawn from a per-thousand-per-year table keyed by the applicant's age by default, or from the sum insured, basis, and manual override you set in the Insurance section. | | **Total monthly payment** | The loan repayment plus compulsory savings plus the creditor life premium. | When you submit, the platform persists the risk band, the integer score, the policy flags, the engine version, and a snapshot of the inputs on the risk assessment record. The other figures above are estimates shown during capture, not separate stored fields on that record. The Adjudicator reviews them when making a decision.